Defame1297
4ea9e21ead
- Fix Copilot format conflation: split CLI vs cloud/IDE in Step 3, clean copilot template to CLI-only fields, add body length limit (30k) - Add missing CC fields to Step 2: disallowedTools, skills, color, initialPrompt, background - Fix Gotchas: add WaitForMcpServers to unavailable tools list, add ExitPlanMode plan-mode carve-out - Make 'Use proactively' conditional (was unconditional directive) - Clarify audit invocation to 'Invoke kyberforge:agent-audit skill directly' - Add 'Would the agent get this wrong?' heuristic to Improve Step 4 - Add agent-audit co-install prerequisite check - Add pre-audit manual checklist to validate/close step - Add references/scripts.md for new-agent.sh conventions - Fix sources.md: remove template/script files from Contributing files (templates can't carry YAML provenance without leaking into user files), add 3 missing research slugs with (none) contributing files - Add context7-github-en-copilot to deployment-modes.md source_keys - Update README.md and references/README.md with new scripts.md entry Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0147vXtL5sP6vorDdqXGJJU9
45 lines
2.1 KiB
Markdown
45 lines
2.1 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/scripts.md` | Conventions for new-agent.sh and any future scripts: contract, template variables, file placement, error messages |
|
|
| `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 |
|