https://github.com/appautomaton/agent-designer
Portable SKILLs workspace for Claude Code, Codex, and Gemini — issue-driven workflows and cross-agent collaboration via bridge scripts with session continuity.
https://github.com/appautomaton/agent-designer
agent-skills agentic-workflows ai-agents ai-coding-assistant claude-code claude-skills codex gemini-cli mcp
Last synced: about 6 hours ago
JSON representation
Portable SKILLs workspace for Claude Code, Codex, and Gemini — issue-driven workflows and cross-agent collaboration via bridge scripts with session continuity.
- Host: GitHub
- URL: https://github.com/appautomaton/agent-designer
- Owner: appautomaton
- Created: 2025-12-20T01:26:41.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-06-09T01:59:25.000Z (19 days ago)
- Last Synced: 2026-06-09T03:17:11.305Z (19 days ago)
- Topics: agent-skills, agentic-workflows, ai-agents, ai-coding-assistant, claude-code, claude-skills, codex, gemini-cli, mcp
- Language: Python
- Homepage:
- Size: 122 KB
- Stars: 118
- Watchers: 1
- Forks: 15
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
Language: English | [中文](README.zh-CN.md)
# 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-antigravity` | Delegate to Antigravity CLI `agy` (review, web search, image analysis) |
| `collaborating-with-gemini` | _Deprecated 2026-06-18_ — Gemini CLI; use `collaborating-with-antigravity` |
| `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]
> 1) (Optional) Use this repo as a template: clone it, remove git history (`rm -rf .git`), re-init (`git init`).
> 2) Write your `AGENTS.md` — project role, constraints, stack, safety rules.
> - To add issue-driven workflow: ask your agent to "apply `AGENTS.issues.template.md` on top of `AGENTS.md`".
> 3) 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-antigravity/ ← bridge script + SKILL.md + references (agy; replaces gemini)
collaborating-with-gemini/ ← deprecated 2026-06-18 (Gemini CLI sunset)
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` + `description` in 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:
- [anthropics/skills](https://github.com/anthropics/skills)
- [GuDaStudio/skills](https://github.com/GuDaStudio/skills)