This repository packages reusable skills for journalism, research, academic writing, verification, and related newsroom work. The skills live in plugin folders and root packages, with separate docs for setup, workflows, and installation across Claude Code and Codex.
Builders who use Claude Code or Codex to research, verify, write, and publish journalism or academic work.
You can load reusable newsroom and research workflows instead of rebuilding them for every project.
AP style, AI-writing cleanup, source verification, fact-checking, FOIA requests, interview prep, newsletter publishing, and photo metadata.
Academic writing, content access, digital archiving, page monitoring, and a curated free-APIs catalog.
Accessibility checks, CLAUDE.md updates, context engineering, test-first bug fixing, web scraping, and CLAUDE.md maintenance.
Installable bundles for Claude Code, plus copy-or-symlink instructions for individual skills.
Lifecycle hooks for checks like source attribution, verification, AP style, and deadline tracking, plus reusable templates and agents.
/plugin marketplace add jamditis/claude-skills-journalism /plugin install pdf-playground@claude-skills-journalism
codex plugin marketplace add jamditis/claude-skills-journalism codex plugin add journalism-core@claude-skills-journalism
npx skills@latest add https://github.com/jamditis/claude-skills-journalism/tree/master/journalism-core \ --skill '*' --agent codex --copy -g -y
npx skills@latest add jamditis/claude-skills-journalism \ --skill fact-check-workflow --agent codex --copy -g -y
"Can you help me verify this viral tweet claiming [X]?" "What steps should I take to verify this document?" "Help me check if this image is authentic"
"Help me prepare questions for interviewing the mayor about the budget" "What background research should I do before this interview?" "Create a question framework for an investigative interview"
A collection of Agent Skills for journalists, researchers, academics, media professionals, and communications practitioners. The same repository serves Claude Code and Codex while keeping Claude-only commands, agents, and hooks clearly labeled.
Docs site: skills.amditis.tech, interactive skill browser, setup guides, and full documentation.
Setup and workflow guides, separate from the skills themselves:
| Guide | Description |
|---|---|
| Autonomous and hands-on dev work | A first-person account of running dev work with Claude in two modes, autonomous sessions that pull tasks off GitHub issues, and hands-on multi-agent reviews at the keyboard, held to one quality bar, with copy-able prompts to adapt the approach to your own agent |
| Multi-agent workflows | Plain-language guide to running many AI agents on one job, fan-out, pipeline, and adversarial-verify patterns, with real examples from ICIJ, The Markup, Full Fact, and Elicit, plus honest cautions |
| Persistent sessions | Keep Claude Code sessions alive through disconnects using tmux, setup, key bindings, activity notifications, and scheduler coexistence |
Skills are modular instruction sets that an AI coding agent loads when relevant to a task. Each skill contains domain knowledge, workflows, templates, and supporting files. Shared skills in this repository follow the Agent Skills specification; Claude and Codex provide their own installation and runtime layers around that shared content.
skills-catalog.yaml lists every package and stable
skill. It records each skill's package, path, lifecycle, and invocation mode.
The defaults preserve the existing model-selected invocation behavior.
Each stable skill includes agents/openai.yaml for Codex display metadata.
These files do not change invocation policy. Run npm run validate:catalog to
check catalog coverage, package mappings, skill names, and metadata files.
See INFLUENCES.md and THIRD_PARTY_NOTICES.md for design credit and license notices.
Choose the section for your client. During the Codex pilot, use only one Codex installation path for a given skill or package.
Prerequisite: You need Claude Code installed. Run claude --version in your terminal to check.
Plugins give you slash commands you can run directly inside Claude Code. Run these two commands inside a Claude Code session:
/plugin marketplace add jamditis/claude-skills-journalism
/plugin install pdf-playground@claude-skills-journalism
Then restart Claude Code (close and reopen). See the PDF Playground README for detailed setup instructions and troubleshooting.
Available plugins:
| Plugin | Description | Commands | Updated |
|---|---|---|---|
| autocontext | Cross-session knowledge persistence with skill evolution. Lessons accumulate per-skill, and /autocontext:evolve folds them back into skill files | /autocontext:setup, /autocontext:init, /autocontext:review, /autocontext:status, /autocontext:evolve | Aug 21, 2026 |
| dev-toolkit | Thirteen development-focused skills for journalists, researchers, and small newsroom dev teams: accessibility, context management, directed multi-agent execution, Electron, mobile debugging, Python pipelines, test-first bug fixing, ethical scraping, no-build frontends, web UI craft, and CLAUDE.md maintenance | /dev-toolkit:director; other skills model-selected | Aug 21, 2026 |
| journalism-core | Fifteen core journalism skills, including AP-style writing, AI-slop detoxing, source verification (deepfakes/C2PA), FOIA + NJ OPRA requests, Brazilian LAI requests, fact-checking, interview prep + transcription, story pitches, editorial workflow, crisis communications, newsletter publishing with current Gmail / Yahoo / Outlook bulk-sender requirements, and embedded photo metadata for wire distribution | n/a, skills only | Aug 21, 2026 |
| okf-wiki | Scaffold an Open Knowledge Format (OKF) knowledge base: one-concept-per-file markdown with YAML frontmatter, directory navigation, and a validator. Generates a starter wiki that passes its own conformance and secret-leak checks, ships session-start hooks that orient Claude on the knowledge base before it works, and includes an optional GitHub-wiki bootstrap. For newsroom institutional memory, research atlases, decision logs, and infrastructure maps | n/a, skill only | Aug 21, 2026 |
| pdf-design | PDF report and proposal design system with brand variables, budget tables, and reusable content blocks (stats strips, three-column, four-tile pillars, partner grids) | n/a, skill-only | Aug 21, 2026 |
| pdf-playground | Create branded proposals, reports, one-pagers, newsletters, slides, and event materials with an interactive control panel for live design editing (colors, fonts, spacing, sections) and a guided wizard for proposals | /pdf-playground:proposal, /pdf-playground:report, /pdf-playground:onepager, /pdf-playground:newsletter, /pdf-playground:slides, /pdf-playground:event, /pdf-playground:preview | Sep 4, 2026 |
| project-templates-toolkit | Three skills for setting up and closing out journalism projects: a CLAUDE.md project-memory writer (institutional knowledge), a LESSONS.md retrospective writer (failures and decisions), and a template-selector decision tree across 6 project types | n/a, skills only | Aug 24, 2026 |
| research-toolkit | Six skills for research, source preservation, and academic workflows: academic writing, legal paywall-bypass via Unpaywall and library databases, web archiving (Wayback / Archive.today / ArchiveBox), web page change monitoring, AI-enriched digital archive construction, and a curated free-API catalog with sunset currency notes (IEX Cloud, CrowdTangle, ProPublica Congress, X, Reddit) | n/a, skills only | Aug 21, 2026 |
| security-toolkit | Four defensive security skills covering OWASP Top 10 fundamentals and supply-chain hardening: pre-deployment audit checklists (auth, input validation, secrets management), secure authentication patterns (password hashing, session management, JWT, OAuth, passkeys), API hardening (rate limiting, CORS, request throttling, defense-in-depth for Express, FastAPI, and serverless), and npm/bun supply-chain hardening with install-time cooldown plus a sandboxed pre-install scan for the bypass case (defends against Mini Shai-Hulud-class worms) | /security-toolkit:hotpatch | Sep 7, 2026 |
| superjawn | Research-augmented fork of obra/superpowers. Default-on research phase fires before brainstorming, systematic-debugging, and writing-skills. Includes all 14 skills with no soft dependencies on the upstream superpowers plugin | invoked indirectly via skills (e.g. superjawn:brainstorming, superjawn:systematic-debugging, superjawn:writing-plans) | Aug 21, 2026 |
| video-toolkit | Four composable skills for social-video accountability reporting: downloading public video from Twitter/X, TikTok, YouTube, Instagram, and Facebook; transcribing it with a provenance sidecar and a CPU path any evaluator can re-run; extracting and vision-analyzing frames; and aggregating the result into an interactive dashboard | n/a, skills only | Aug 21, 2026 |
| web-design-picker | Build two to five distinct website directions, a switchable client review site, downloadable design assets, preview images, static QA reports, and separate Cloudflare Drop and design-handoff packages | n/a, skill only | Sep 2, 2026 |
| visual-explainer | HTML diagrams, data tables, architecture views, slide decks, and KPI dashboards adapted from nicobailon/visual-explainer with journalism, newsroom, and academic design sensibilities | /visual-explainer:project-recap | Aug 21, 2026 |
Most skills live inside a plugin's skills/ directory. The okf-wiki/SKILL.md, pdf-design/SKILL.md, visual-explainer/SKILL.md, and web-design-picker/SKILL.md root-skill packages keep the skill at the package root. To install one skill without taking a whole plugin, clone the repo and copy or symlink the directory that directly contains its SKILL.md. Claude Code discovers skills at ~/.claude/skills/<skill-name>/SKILL.md, one level deep:
git clone https://github.com/jamditis/claude-skills-journalism.git ~/projects/claude-skills-journalism
cd ~/projects/claude-skills-journalism
mkdir -p ~/.claude/skills
# Pull a single skill out of a plugin's skills/ directory:
cp -r journalism-core/skills/source-verification ~/.claude/skills/
cp -r research-toolkit/skills/free-apis-catalog ~/.claude/skills/
cp -r research-toolkit/skills/web-archiving ~/.claude/skills/
cp -r dev-toolkit/skills/web-scraping ~/.claude/skills/
cp -r dev-toolkit/skills/director ~/.claude/skills/
cp -r security-toolkit/skills/secure-auth ~/.claude/skills/
cp -r project-templates-toolkit/skills/project-memory ~/.claude/skills/
# A root-skill package is already the directory to copy:
cp -r okf-wiki ~/.claude/skills/
cp -r web-design-picker ~/.claude/skills/
# Or symlink so git pull updates them in place (ln -sfn replaces an existing link):
ln -sfn "$PWD/research-toolkit/skills/free-apis-catalog" ~/.claude/skills/free-apis-catalog
ln -sfn "$PWD/dev-toolkit/skills/director" ~/.claude/skills/director
ln -sfn "$PWD/web-design-picker" ~/.claude/skills/web-design-picker
ln -sfn "$PWD/visual-explainer" ~/.claude/skills/visual-explainer
The standalone copy or link invokes the skill as /director. The installed
plugin invokes it as /dev-toolkit:director because Claude Code namespaces
plugin skills.
Do not clone the repo directly into ~/.claude/skills/journalism-skills/, that nests each SKILL.md too deep and Claude Code won't find them.
Prerequisite: Install Codex CLI. Run codex --version in your terminal to check. The legacy-compatible package route below is verified with Codex CLI 0.147.0.
Codex can install journalism-core through this repository's Claude marketplace metadata:
codex plugin marketplace add jamditis/claude-skills-journalism
codex plugin add journalism-core@claude-skills-journalism
This legacy-compatible package route exposes the 15 nested journalism-core skills. It does not convert Claude commands, agents, hooks, or root-level skills into Codex components. This repository ships Codex UI metadata but no native Codex plugin manifests.
You can instead install standards-based skills with the skills CLI. This user-level command makes the 15 core skills available across your Codex projects:
npx skills@latest add https://github.com/jamditis/claude-skills-journalism/tree/master/journalism-core \
--skill '*' --agent codex --copy -g -y
That command installs journalism-core in Codex's documented user skill directory, ~/.agents/skills. The clean-install canary checks that exact global destination. Remove -g to install into the current project's .agents/skills directory and record the source and content hashes in that project's skills-lock.json. To install one skill instead:
npx skills@latest add jamditis/claude-skills-journalism \
--skill fact-check-workflow --agent codex --copy -g -y
Codex desktop can import skills from another agent. Import leaves the source installation in place. Until duplicate-identity and uninstall behavior has been tested for this repository, do not import a skill and also install the same skill through npx skills or the package route.
Codex's bundled skill installer writes to a different Codex-specific directory and is not a tested installation path for this repository. Codex does not deduplicate same-name skills across install roots, so don't combine it with the .agents/skills route above.
Use only one Codex installation path for the same skill identity.
See the checked-in Codex compatibility matrix for tested versions, package boundaries, and pending runtime gates. A valid install is not a package-wide runtime support claim. The historical pilots remain tied to their recorded snapshots.
Skills can be added via the Claude.ai interface under Settings > Skills.
The Updated column in every table below is the date that skill or plugin last
changed, taken from git history rather than typed by hand. Use it to judge
whether your installed copy has drifted: a skill that cites statutes, platform
APIs, or vendor behavior is worth re-checking against its sources once it is
several months old. The same dates appear as tape on each card at
skills.amditis.tech, where the tape yellows with
age.
journalism-core plugin)These fifteen skills ship together as the journalism-core plugin. Install via /plugin install journalism-core@claude-skills-journalism to get all of them at once.
| Skill | Description | Updated |
|---|---|---|
| ai-writing-detox | Eliminate AI-generated patterns that erode reader trust. Banned words, phrases, and structures with alternatives | Aug 21, 2026 |
| brazil-records-requests | Public records requests under Brazil's Access to Information Law (Lei 12.527/2011), portal selection across federal, state, municipal, judicial and legislative bodies; deadlines; the four-level appeal chain (first instance, agency head, CGU, CMRI); templates in Portuguese with English glosses | Aug 21, 2026 |
| crisis-communications | Breaking news protocol, rapid verification, crisis response, misinformation countering | Aug 21, 2026 |
| data-journalism | Dataset analysis, chart and map creation, statistical reasoning, data-driven story structure | Aug 21, 2026 |
| editorial-workflow | Story assignment tracking, deadline management, editorial calendars, handoff protocols | Aug 21, 2026 |
| fact-check-workflow | Claim extraction, evidence gathering, rating scales, correction protocols | Aug 21, 2026 |
| foia-requests | Public records request drafting (federal FOIA + NJ OPRA), tracking, appeals, current statutory citations | Aug 21, 2026 |
| interview-prep | Pre-interview research, question frameworks, recording consent, attribution guidelines | Aug 21, 2026 |
| interview-transcription | Whisper / WhisperX transcription pipelines, quote management, speaker diarization | Aug 21, 2026 |
| newsletter-publishing | Email newsletter creation, subscriber management, deliverability, 2024–2026 Gmail / Yahoo / Outlook bulk-sender compliance | Aug 21, 2026 |
| newsroom-style | AP Style enforcement, attribution rules, headline formatting, number conventions | Aug 21, 2026 |
| photo-metadata | Embed caption, byline, credit, alt text, keywords, copyright / Creative Commons license, AI-source labeling (IPTC Digital Source Type), and Google-Images licensing into a photo's IPTC/EXIF/XMP metadata; strip GPS for source protection; read C2PA Content Credentials; batch-tag a folder for a news wire | Aug 21, 2026 |
| social-media-intelligence | Narrative tracking, coordinated-campaign analysis, account authenticity checks, OSINT for digital investigations | Aug 21, 2026 |
| source-verification | SIFT method, image and video verification, deepfake detection (2026), C2PA Content Credentials, verification trails | Aug 21, 2026 |
| story-pitch | Pitch templates for daily news, features, investigations, op-eds, and freelance queries | Aug 21, 2026 |
research-toolkit plugin)These six skills ship together as the research-toolkit plugin. Install via /plugin install research-toolkit@claude-skills-journalism to get all of them at once.
| Skill | Description | Updated |
|---|---|---|
| academic-writing | Research design, literature reviews, IMRaD structure, peer review responses, grant proposals | Aug 21, 2026 |
| content-access | Unpaywall, CORE, Semantic Scholar APIs, library databases, ethical access patterns | Aug 21, 2026 |
| digital-archive | Building archives with AI enrichment, entity extraction, knowledge graphs | Aug 21, 2026 |
| free-apis-catalog | Curated free-API catalog organized by journalism use-case, with currency notes for major API sunsets (IEX Cloud, CrowdTangle, ProPublica Congress, X, Reddit) and an evaluation rubric | Aug 21, 2026 |
| page-monitoring | Change detection, RSS generation, webhook alerts, automatic archiving on changes | Aug 21, 2026 |
| web-archiving | Wayback Machine, Archive.today, legal evidence preservation, multi-archive redundancy | Aug 21, 2026 |
| Skill | Description | Updated |
|---|---|---|
| pdf-design | Professional PDF reports and proposals with brand system, budget tables, and multi-page layouts. For the full interactive experience, use pdf-playground instead | Aug 21, 2026 |
| web-design-picker | Produce distinct responsive website directions, a client review picker, downloadable design assets, preview images, static QA reports, and deployment and handoff packages | Sep 2, 2026 |
| visual-explainer | Turn complex data into styled HTML pages, architecture diagrams, data tables, flowcharts, timelines, source maps, and dashboards with dark/light theme support. Now registered as a plugin (/plugin install visual-explainer@claude-skills-journalism) | Aug 21, 2026 |
This skill ships inside the pdf-playground plugin.
| Skill | Description | Updated |
|---|---|---|
| document-design | Create print-ready HTML proposals, reports, one-pagers, newsletters, slides, flyers, and other PDF-ready documents with reusable brand and layout patterns | Sep 4, 2026 |
These fourteen skills ship inside the superjawn plugin.
| Skill | Description | Updated |
|---|---|---|
| brainstorming | Explore intent, requirements, design, and relevant research before creative implementation work | Aug 21, 2026 |
| dispatching-parallel-agents | Divide independent tasks among parallel agents without shared-state conflicts | Aug 21, 2026 |
| executing-plans | Execute a written implementation plan with freshness and review checkpoints | Aug 21, 2026 |
| finishing-a-development-branch | Verify completed work and choose a safe integration, pull request, or cleanup path | Aug 21, 2026 |
| receiving-code-review | Evaluate review feedback against the code before implementing it | Aug 21, 2026 |
| requesting-code-review | Request focused review before integration or after a major implementation | Aug 21, 2026 |
| subagent-driven-development | Execute independent plan tasks with agents in the current session | Aug 21, 2026 |
| systematic-debugging | Investigate root cause and relevant evidence before proposing a bug fix | Aug 21, 2026 |
| test-driven-development | Write a failing test before implementing a feature or bug fix | Aug 21, 2026 |
| using-git-worktrees | Create isolated worktrees with safe directory selection and verification | Aug 21, 2026 |
| using-superjawn | Discover and invoke the right Superjawn skill for the current task | Aug 21, 2026 |
| verification-before-completion | Run and inspect verification evidence before claiming work is complete | Aug 21, 2026 |
| writing-plans | Turn a specification or requirements into a checked implementation plan | Aug 21, 2026 |
| writing-skills | Research, create, edit, and verify reusable skills | Aug 21, 2026 |
project-templates-toolkit plugin)These three skills ship together as the project-templates-toolkit plugin. Install via /plugin install project-templates-toolkit@claude-skills-journalism to get all of them at once.
| Skill | Description | Updated |
|---|---|---|
| project-memory | Generate CLAUDE.md files that capture project-specific knowledge. Includes templates for editorial tools, events, publications, research, pipelines, and archives | Aug 21, 2026 |
| project-retrospective | Generate LESSONS.md files that document what worked and what didn't. Templates for investigations, events, publications, and tools | Aug 21, 2026 |
| template-selector | Decision tree for choosing the right project documentation template | Aug 21, 2026 |
dev-toolkit plugin)These thirteen skills ship together as the dev-toolkit plugin. Install via /plugin install dev-toolkit@claude-skills-journalism to get all of them at once, or copy individual skills from dev-toolkit/skills/<name>/.
| Skill | Description | Updated |
|---|---|---|
| accessibility-compliance | WCAG 2.2 baseline, alt text, focus management, motion preferences, accessible charts | Aug 21, 2026 |
| claude-md-updater | Detect session lessons, new paths, infra changes, and workflows and propose scoped CLAUDE.md edits for approval | Aug 21, 2026 |
| context-engineering-fundamentals | Attention budget, lost-in-middle recall, context degradation patterns, and mitigations for long sessions | Aug 21, 2026 |
| [director](./dev-too |
Sign in to join the discussion.
No comments yet. Be the first to say what this is good for.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.
Public repository for Agent Skills
Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)
Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.
A skill to stop your coding agent from burying the answer. ADHD-friendly output.