When to use
- Setting up new journalism projects
- Onboarding collaborators to existing projects
- Documenting project-specific quirks and gotchas
- Creating context for AI assistants working on your code
What's included
Deletion test
Guidelines for cutting obvious information. If an experienced journalist already knows it, delete it.
6 project templates
Editorial tools, event websites, publications, research projects, content pipelines, and digital archives.
Voice guidelines
Direct, terse notes. No marketing language. No "Welcome to..." introductions.
Good vs. bad examples
Side-by-side comparisons of verbose documentation vs. institutional knowledge only.
Pinned repository ledger
A reference for one pinned issue per repository that holds live status, active holds, and a message board when several agents or people share the work.
What belongs in a project instruction file
| Include | Don't include |
|---|---|
| Project-specific quirks | How journalism works generally |
| YOUR naming conventions | Standard file organization |
| Commands with YOUR flags | Generic commands like "npm install" |
| Non-obvious architecture | Framework documentation |
| Common mistakes in THIS project | General best practices |
Choose the right mechanism
| Mechanism | Use for |
|---|---|
| Project instruction file | Standing facts, commands, conventions, and boundaries |
| Skill | Fact-check workflows, FOIA-letter drafting, and other multi-step procedures |
| Client enforcement | Rules that must block or run every time, such as a Claude Code hook that exits 2. Prompt hooks only remind. |
Client-specific locations
Claude Code
/etc/claude-code/CLAUDE.md or the documented macOS and Windows managed-policy paths; ./CLAUDE.md or ./.claude/CLAUDE.md; ~/.claude/CLAUDE.md; and gitignored ./CLAUDE.local.md.
Codex
~/.codex/AGENTS.md, then AGENTS.md files from the repository root through the working directory. AGENTS.override.md replaces the file at the same scope.
Memory and institutional knowledge
In Claude Code v2.1.59 and later, auto memory stores corrections under ~/.claude/projects/<project>/memory/. Do not ask users to copy those notes into shared project instructions.
# Project instructions
## Gotchas
- Story slugs must be unique across all desks, not only metro.
- "Hold" does not stop the autopublish cron. Use "Kill."
- The reporter dropdown caches for one hour.
## Commands
npm run sync-ap # Pull latest from AP. Runs automatically at :15.
## Credentials
The Supabase key is in the 1Password "Metro Desk" vault, not .env.Template selector
editorial-tool.md
Newsroom tools, fact-checkers, AI assistants
event-website.md
Conferences, workshops, campaign sites
publication.md
Newsletters, podcasts, ongoing content series
research-project.md
Investigations, data journalism with defined scope
content-pipeline.md
CMS workflows, publishing automation
digital-archive.md
Historical collections, document repositories
Length guideline
Treat 200 lines as a review threshold, not a target. If the file grows, move procedures to skills, narrow rules to nested instruction files, and transient notes to client memory.
The best project instruction files capture quirks that caused real mistakes.
Sources: Claude Code memory, Claude Code best practices, and official Codex AGENTS.md guidance. Claude sources last swept May 9, 2026; Codex scoping checked Oct. 23, 2026.
Installation
# Recommended: install the project-templates-toolkit plugin
/plugin marketplace add jamditis/claude-skills-journalism
/plugin install project-templates-toolkit@claude-skills-journalism
# Or copy just this skill from the plugin tree
git clone https://github.com/jamditis/claude-skills-journalism.git
mkdir -p ~/.claude/skills ~/.agents/skills
cp -r claude-skills-journalism/project-templates-toolkit/skills/project-memory ~/.claude/skills/ # Claude Code
cp -r claude-skills-journalism/project-templates-toolkit/skills/project-memory ~/.agents/skills/ # Codex
Or browse this skill in the GitHub repository.
Related skills
Document what matters
Templates for institutional knowledge, not generic documentation.
View on GitHub