dev-team

Dev Team Skill

dev-team is a reusable skill for running meaningful engineering work like a small development team.

It guides coding agents through a practical agentic loop:

1. Clarify only what matters.
2. Explore the codebase before planning.
3. Build a concise plan with validation.
4. Split work into tasks when useful.
5. Delegate parallel work when safe and authorized.
6. Implement, validate, review, fix, and prepare for handoff.

The skill is intentionally small. The main workflows live in dev-team/SKILL.md for Codex and plugins/dev-team/skills/dev-team/SKILL.md for Claude Code; deeper guidance lives in references/ and is loaded only when useful.

Install For Codex

Copy the dev-team folder into your Codex skills directory:

mkdir -p ~/.codex/skills
cp -R dev-team ~/.codex/skills/dev-team

Restart Codex so it can pick up the new skill.

Install For Claude Code

For the short /dev-team command, install the standalone Claude Code skill:

mkdir -p ~/.claude/skills
cp -R plugins/dev-team/skills/dev-team ~/.claude/skills/dev-team

Restart Claude Code if the top-level skills directory did not exist before. Otherwise run /reload-plugins or continue; Claude Code watches existing skill directories for changes.

For plugin testing or marketplace-style installation, this repo also includes a Claude Code plugin:

claude --plugin-dir ./plugins/dev-team

Then invoke the plugin skill from Claude Code. Plugin skills are namespaced by the plugin, so use:

/dev-team:dev-team implement this feature

To install through Claude Code's plugin marketplace flow:

/plugin marketplace add illourr/dev-team-skill
/plugin install dev-team@dev-team-skill
/reload-plugins

Use

Invoke the skill explicitly:

$dev-team implement this feature

or:

/dev-team fix this flaky test

Explicit invocation means you are opting into the fuller workflow, including task splitting and parallel agents when safe and available.

What It Is Good For

• Feature work
• Bug fixes
• Refactors
• CI fixes
• Migrations
• Ambiguous implementation requests
• PR readiness and handoff

What It Avoids

• Asking questions just to perform ceremony
• Delegating work when tasks are tightly coupled
• Pushing, opening PRs, deploying, running migrations, or using destructive commands without explicit approval
• Replacing user judgment on product, rollout, or safety decisions

Structure

dev-team/
  SKILL.md
  agents/
    openai.yaml
  references/
    clarification-gates.md
    context-capture.md
    review-rubric.md
    task-splitting.md
    validation-and-rollout.md
plugins/
  dev-team/
    .claude-plugin/
      plugin.json
    agents/
      explorer.md
      planner.md
      reviewer.md
    skills/
      dev-team/
        SKILL.md
        references/
.claude-plugin/
  marketplace.json

Compatibility

This repository supports:

• Codex skill installation from dev-team/
• Claude Code standalone skill installation from plugins/dev-team/skills/dev-team/
• Claude Code plugin loading from plugins/dev-team/
• Claude Code marketplace installation via .claude-plugin/marketplace.json

License

MIT