Skip to content

photostructure/claude-code-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Code coding skills

An opinionated Claude Code plugin marketplace with eight workflow skills for disciplined planning, proof-based review, clean commits, and multi-session Technical Project Plans (TPPs). Documented in depth at photostructure.com/coding.

Skill What it does Read more
replan Iterative critique-and-refine planning. Forces multiple passes before committing to a design. Claude picks the first idea that works. Make it pick the best one.
review Code review that requires proof before reporting — a short list of real bugs, not noise. Most AI code reviews are noise. Here's how to fix that.
review-staged The same proof-based review, scoped to git diff --cached, then drives a clean commit. Most AI code reviews are noise. Here's how to fix that.
gitplan Untangle a large working tree into coherent, single-purpose Conventional Commits.
stage Stage only the hunks the current session touched — never the whole file — and commit cleanly.
tpp Work on a Technical Project Plan: read the plan, do the current phase, record discoveries. Bundles a reference TPP-GUIDE.md. Claude Code has amnesia. So do PRs, changelogs, and your future self.
handoff Update the active TPP before context runs out, so the next session continues instead of restarting. Claude Code has amnesia. So do PRs, changelogs, and your future self.
tpp-orchestrate Execute a queue of TPPs serially: TDD subagents, dual independent reviews, every finding vetted against ground truth, one commit per plan. Claude Code has amnesia. So do PRs, changelogs, and your future self.

Install

# Add the marketplace (from GitHub: owner/repo)
/plugin marketplace add photostructure/claude-code-skills

# Install the bundled plugin
/plugin install coding@photostructure

Then invoke any skill — plugin skills are namespaced by the plugin name:

/coding:replan
/coding:review
/coding:gitplan

To try it locally before publishing:

/plugin marketplace add /home/mrm/src/claude-code-skills
/plugin install coding@photostructure

Layout

claude-code-skills/
├── .claude-plugin/
│   └── marketplace.json        # marketplace catalog (name: photostructure)
└── plugins/
    └── coding/                 # the plugin (skills namespaced as /coding:<name>)
        ├── .claude-plugin/
        │   └── plugin.json
        └── skills/
            ├── replan/SKILL.md
            ├── review/SKILL.md
            ├── review-staged/SKILL.md
            ├── gitplan/SKILL.md
            ├── stage/SKILL.md
            ├── tpp/
            │   ├── SKILL.md
            │   └── TPP-GUIDE.md    # bundled reference guide (project docs/TPP-GUIDE.md wins)
            ├── handoff/SKILL.md
            └── tpp-orchestrate/SKILL.md

Adapting

These skills are intentionally generic. Each SKILL.md ends with an "Adapting for your project" note — point them at your CLAUDE.md/AGENTS.md, add domain-specific critique or review checks, and tune the strictness to taste.

Further reading

The thinking behind these skills, on photostructure.com/coding:

Versioning

plugin.json has no version field, so while this marketplace is hosted in git every commit counts as a new version and /plugin update picks up changes automatically. Add an explicit version once you want stable, opt-in releases.

License

MIT © Matthew McEachen

About

Opinionated Claude Code workflow skills: iterative planning, proof-based review, and clean Conventional Commits.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors