Defame1297
5a6b2a4c8b
## Why Same gap as skill-author: no instruction to bump the plugin version after creating or modifying an agent inside a plugin. Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
# agent-author
|
|
|
|
Creates and improves agent definition files for Claude Code and GitHub Copilot CLI.
|
|
|
|
## What it does
|
|
|
|
Scaffolds and fills in agent definition files (`.md` for Claude Code, `.agent.md` for Copilot CLI) at plugin, project, or user scope. Always generates both provider files in one pass. Also applies improvement signals — grill output, inline feedback, session context — to existing agent files. Bumps the plugin version in both manifests after every change (minor for new agents, patch for improvements).
|
|
|
|
## Before you start
|
|
|
|
Have ready: the agent's name (kebab-case), the root directory (plugin root, project root, or `~`), a one-sentence purpose, and the triggering condition (when should the runtime delegate to this agent?).
|
|
|
|
## Usage
|
|
|
|
```
|
|
/agent-author
|
|
```
|
|
|
|
**Manual scaffold (human workflow):**
|
|
```bash
|
|
bash scripts/new-agent.sh <agent-name> <root>
|
|
|
|
# Examples:
|
|
bash scripts/new-agent.sh code-reviewer plugins/kyberforge/
|
|
bash scripts/new-agent.sh deploy-assistant .
|
|
bash scripts/new-agent.sh security-reviewer ~
|
|
```
|
|
|
|
## Files
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `SKILL.md` | Skill instructions for agents |
|
|
| `scripts/new-agent.sh` | Scaffolds Claude Code and Copilot CLI agent files from templates |
|
|
| `references/deployment-modes.md` | Plugin vs project vs user scope: restrictions, scoped identifiers, path conventions |
|
|
| `references/sources.md` | Research provenance — sources that informed this skill |
|
|
| `assets/templates/claude-code.md` | Annotated Claude Code agent definition template |
|
|
| `assets/templates/copilot.agent.md` | Annotated Copilot CLI agent definition template |
|
|
| `tests/new-agent.bats` | bats tests for `scripts/new-agent.sh` |
|
|
| `assets/README.md` | Directory meta-documentation for assets/ |
|
|
| `references/README.md` | Directory meta-documentation for references/ |
|
|
| `scripts/README.md` | Directory meta-documentation for scripts/ |
|
|
| `tests/README.md` | bats dependency instructions and run command |
|