Agent Designer
Purpose Design and maintain Codex/Claude-style SKILLs, plus supporting docs and MCP tool catalog.
Installation
npx agent-designerAsk AI about Agent Designer
Powered by Claude Β· Grounded in docs
I know everything about Agent Designer. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Language: English | δΈζ
Agent Designer
A portable skills workspace for AI coding agents β Codex, Claude Code, and Gemini.
Design structured, reusable skills that give your agents clear workflows, safe defaults, and multi-turn collaboration capabilities. Clone this repo as a starting point for any project where you want agents to work methodically rather than freestyle.
What's inside
Collaboration skills β let your agents delegate to each other via bridge scripts with session continuity:
| Skill | Purpose |
|---|---|
collaborating-with-claude | Delegate to Claude Code CLI (review, diff, consultation) |
collaborating-with-gemini | Delegate to Gemini CLI (review, web search, image analysis) |
collaborating-with-codex | Delegate to Codex CLI (implementation, diagnosis, review) |
Issue-driven development β structure work into plans and trackable Issue CSVs:
| Skill | Purpose |
|---|---|
issue-driven-workflow | Plan β Issue CSV β autonomous execution with status tracking |
Getting started
[!TIP]
- (Optional) Use this repo as a template: clone it, remove git history (
rm -rf .git), re-init (git init).- Write your
AGENTS.mdβ project role, constraints, stack, safety rules.
- To add issue-driven workflow: ask your agent to "apply
AGENTS.issues.template.mdon top ofAGENTS.md".- Start working β ask your agent to create a plan, generate an Issue CSV, or collaborate with another agent.
- Example: "Create a plan and Issue CSV for ."
Project structure
skills/ β skill source (the real content)
collaborating-with-claude/ β bridge script + SKILL.md + references
collaborating-with-gemini/ β bridge script + SKILL.md + references
collaborating-with-codex/ β bridge script + SKILL.md + references + prompt recipes
issue-driven-workflow/ β plan/CSV workflow + templates + scripts
.codex/skills/ β symlinks (Codex wiring)
AGENTS.md β project-specific rules
AGENTS.issues.template.md β issue-driven workflow (apply on top of AGENTS.md)
How it works
Each skill follows progressive disclosure:
- Level 1 (metadata) β
name+descriptionin YAML frontmatter. Always loaded. Used for discovery. - Level 2 (instructions) β the SKILL.md body. Loaded when the skill is invoked. Contains workflow, safety, quick start.
- Level 3 (resources) β
scripts/,references/,assets/. Loaded on demand. Contains deep docs, templates, helper scripts.
Notes
- This repo is workflow-first β most changes are text, not code.
- Bridge scripts wrap CLI tools and return structured JSON with session continuity.
- Skills are portable across Codex and Claude Code with minimal adaptation.
- If invoking bridge scripts directly, prefer
python3.
Acknowledgements
Inspired by:
