Skip to main content
plugin CX Codex

development-skills — Claude Code plugin: what it does, how to install

development-skills adds disciplined engineering workflows with risk-tiered execution, on-disk decision chronicles, and fresh-eyes subagent review.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install development-skills@awesome-codex-plugins
Open on GitHub

What development-skills does

The plugin routes every task into the smallest safe workflow via shared/development-loop.md. Straightforward changes run on the Direct path without overhead. Medium tasks trigger the Bounded path for targeted reviews. Deep tasks switch to the Full path, generating actionable plans in docs/plans/ and saving decision histories with rejected alternatives into docs/chronicles/.

Included in the bundle are 22 skills and a dedicated staff-reviewer subagent that inspects patches from an isolated context. Skills like refactor, simplify-stuff, phone-a-friend, and wrap-up-branch need manual invocation. For an outside opinion, phone-a-friend consults the companion CLI family in read-only mode, while bro switches explanations into plain English without losing technical substance.

The system enforces no rigid language standards out of the box, reading conventions directly from the host project. If a particular Codex setup ignores plugin hooks, run the formatter manually with hooks/auto-format.

What it helps with

  • record architecture decisions and rejected paths on disk
  • run independent code reviews using an isolated subagent
  • select appropriate development workflows based on task risk
  • align repository documentation with recent code edits

Example prompts for the agent

  • Run using-development-skills to design the upcoming feature
  • Invoke staff-review on the staged changes
  • Use refactor to clean up this function safely

How to install development-skills

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install development-skills@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about development-skills

How to install development-skills in Claude Code?

Run both commands sequentially: /plugin marketplace add hashgraph-online/awesome-codex-plugins followed by /plugin install development-skills@awesome-codex-plugins.

What does development-skills do?

It structures agent workflows into three risk-calibrated tiers, records durable decision logs on disk, and provides a fresh-eyes subagent reviewer.

What hooks are included in development-skills?

It provides session-start to register routing contracts, auto-format to format edits, and plan-approved to proceed once a plan receives user sign-off.

Source text

development-skills · MIT
<div align="center">

# development-skills

**A disciplined engineering workflow for [Claude Code](https://docs.claude.com/en/docs/claude-code) and [Codex CLI](https://github.com/openai/codex).**

Use the smallest safe workflow, keep important decisions on disk, and verify claims with evidence.

<a href="https://github.com/reidemeister94/development-skills/releases"><img src="https://img.shields.io/github/v/release/reidemeister94/development-skills?style=flat-square&color=2563EB" alt="Release"/></a>
<a href="LICENSE"><img src="https://img.shields.io/github/license/reidemeister94/development-skills?style=flat-square" alt="License"/></a>

</div>

---

## Install

Claude Code:

```text
/plugin marketplace add reidemeister94/development-skills
/plugin install development-skills@development-skills
```

Codex CLI:

```bash
codex plugin marketplace add reidemeister94/development-skills
```

Then open `/plugins`, find `development-skills`, and install it.

The plugin activates for development work.
Hooks run automatically on Claude Code and supported Codex versions.
When Codex does not load plugin hooks, run the relevant formatter manually with [`hooks/auto-format`](hooks/auto-format).

## How it works

[`shared/development-loop.md`](shared/development-loop.md) selects the smallest path that fits the work:

| Path | Use it when | Work record |
|---|---|---|
| Direct | One clear, reversible change has a known proof. | None. |
| Bounded | The result is clear, but several modules or a high-impact contract need review. | Chat summary and independent review when risk requires it. |
| Full | Decisions need lasting reasons, proof needs design, or another session must resume the work. | A plan and decision chronicle. |

The full path keeps two files:

- `docs/plans/YYYY-MM-DD__<slug>.md` records design, exact work, checks, and current state.
- `docs/chronicles/YYYY-MM-DD__<slug>.md` records the request, reasons, rejected alternatives, and useful failed approaches.

The user approves a presented plan before implementation.
Approved work continues through implementation, verification, independent review, explanation when useful, and documentation alignment.

## Included capabilities

The plugin ships 22 skills:

| Area | Skills |
|---|---|
| Core workflow | `using-development-skills`, `brainstorming`, `create-test`, `explain-diff` |
| Review and improvement | `staff-review`, `roast-my-code`, `refactor`, `simplify-stuff`, `rethink` |
| Documentation and Git | `align-docs`, `changelog`, `commit`, `handoff`, `resolve-merge`, `wrap-up-branch` |
| Research and evaluation | `best-practices`, `ai-agent-bench`, `eval-regression`, `phone-a-friend`, `plugin-feedback` |
| Communication and maintenance | `bro`, `update-deps` |

`refactor`, `simplify-stuff`, `phone-a-friend`, and `wrap-up-branch` require explicit invocation.
`bro` switches explanations to plain language without dropping necessary facts.
`phone-a-friend` asks the other CLI family for an independent, read-only opinion.

One named subagent ships: [`staff-reviewer`](agents/staff-reviewer.md).
Implementation and verification stay in the main context.

## Shared contracts

- [`development-loop.md`](shared/development-loop.md) owns scope, authorization, path selection, and completion.
- [`full-path.md`](shared/full-path.md) owns persistent work records and full-path steps.
- [`engineering.md`](shared/engineering.md) owns language-agnostic code and design rules.
- [`writing.md`](shared/writing.md) owns plain natural-language text.
- [`documentation.md`](shared/documentation.md) owns repository document metadata and lifecycle.
- [`review-categories.md`](shared/review-categories.md) owns severity definitions.

The plugin does not ship language, framework, organization, or product conventions.
It reads those rules from the target repository.

## Hooks

| Hook | Purpose |
|---|---|
| `session-start` | Inject the router and writing contract before the first decision. |
| `auto-format` | Apply a best-effort formatter after an edit. |
| `plan-approved` | Continue approved work without asking for the same approval again. |

Claude Code also loads [`shared/writing.md`](shared/writing.md) as the plugin output style.

## Acknowledgments

Inspired by [superpowers](https://github.com/obra/superpowers) by Jesse Vincent.
This project adds risk-based paths, persistent decision records, one clean-context reviewer, and language-agnostic contracts.

## Contributing

Open an issue before substantial work, then read [CONTRIBUTING.md](CONTRIBUTING.md).

## License

[MIT](LICENSE)

© hashgraph-online · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Code review and refactoring →

From the same set391

The whole set →
dryforge dryforge — a bounded-autonomy plugin: the agent asks only the decisions that are yours and writes nothing until the intent is approved. CX Codex ★ 1,596repo stars done-gate done-gate stops coding agents from claiming a bug is fixed without running tests in the current turn. Prompts the agent to verify code before finishing. CX Codex ★ 1,596repo stars docflow docflow gives coding agents a Markdown-based project memory, readiness checks, and a monthly changelog. Use it when sessions need shared documentation context. CX Codex ★ 1,596repo stars devrecap devrecap turns the Claude and Claude session history you authorize, plus read-only Git, into a daily standup, sprint recap or weekly review as an HTML report. CX Codex ★ 1,596repo stars devin The plugin puts Devin inside Claude and Claude: code reviews that only read files, adversarial passes, delegated tasks and cloud handoff to app.devin.ai. CX Codex ★ 1,596repo stars designer-skill designer-skill is a plugin for Claude Code and Codex that routes UI design requests, retrieves guides, and checks code against 44 static rules without an API key. CX Codex ★ 1,596repo stars design-helper The design-helper plugin puts CSS, layout, and motion options side by side in a browser, then applies your choice to the project. Use it before committing to a UI change. CX Codex ★ 1,596repo stars delx-recovery delx-recovery — a plugin that reopens an agent's earlier sessions, records where the work stands and turns failures into a recovery plan. Session memory sits on a hosted MCP server. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open