Defame1297
874bf06b18
Output of apm pack, sync-plugin-content.sh --all and sync-marketplace-mirror.sh against this round's source changes. No file here is hand-edited. Carries the version bumps and marketplace owner.email into the compiled manifests, the disallowedTools frontmatter and doc corrections into the flat mirrors, and changes plugins/bin/.github/plugin/plugin.json's mcpServers from the inlined server object to the ".mcp.json" pointer. That last file also returns to 0644: the previous re-injection wrote it through mktemp and carried 0600 across, which no gate could see because the mode check did not cover .github/plugin/ and git tracks only the exec bit. .agents/plugins/marketplace.json is unchanged and that is correct -- apm's codex profile carries neither version nor owner keys, so nothing in this round reaches it. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01X7GvKuJfy2WrdBmUttV4DT
63 lines
3.7 KiB
Markdown
63 lines
3.7 KiB
Markdown
# skill-author
|
|
|
|
Author and refine skills conforming to the [agentskills.io](https://agentskills.io) specification — create new skills from scratch or apply improvement signals to existing ones.
|
|
|
|
## What it does
|
|
|
|
Routes to one of two flows based on context: if no skill directory exists at the target path, it scaffolds the directory from annotated templates, fills in `SKILL.md` and supporting files, and validates the result. If an existing skill directory and improvement signals are both present, it groups those signals by root cause and applies targeted edits, then re-validates. In both flows, bumps the skill's `metadata.version` when present (minor for create, patch for improve).
|
|
|
|
## Before you start
|
|
|
|
- Run `/grill-me` to resolve design decisions before creating a new skill
|
|
- Collect domain research, examples, and constraints
|
|
- Know the skill name (kebab-case) and destination path
|
|
|
|
## Placement
|
|
|
|
`scripts/new-skill.sh` resolves the mode automatically by walking up from the given path — see `SKILL.md` Step 1 for the full algorithm.
|
|
|
|
| Mode | Path | Chosen when |
|
|
|------|------|-------------|
|
|
| Standalone | `<path>/<name>/` | No `apm.yml` with a top-level `type:` field is found walking up from `<path>`, before hitting `.git` or the filesystem root |
|
|
| Package (APM) | `<package-root>/.apm/skills/<name>/` | A type-bearing `apm.yml` is found at or above `<path>` — `<path>` just needs to be somewhere inside the package |
|
|
|
|
If the destination resolves inside an APM package, read `references/deployment-modes.md` — self-containment rules apply to `apm compile` output the same way they applied to plugin cache isolation.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/skill-author
|
|
```
|
|
|
|
## Files
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `README.md` | Human-readable overview of the skill and its files |
|
|
| `SKILL.md` | Skill instructions for agents |
|
|
| `scripts/new-skill.sh` | Walks up from the given path to resolve package vs standalone mode, then copies annotated templates to the resolved destination |
|
|
| `references/deployment-modes.md` | APM package vs standalone differences and self-containment/cache-isolation rules (loaded on demand) |
|
|
| `references/scripts.md` | Package runners, inline dependency patterns, and full script contract (loaded on demand) |
|
|
| `references/sources.md` | Upstream research sources and which skill files each contributed to |
|
|
| `assets/templates/SKILL.md` | Annotated SKILL.md template |
|
|
| `assets/templates/README.md` | Annotated README template for the new skill |
|
|
| `assets/templates/scripts/README.md` | Placeholder for bundled scripts |
|
|
| `assets/templates/references/README.md` | Placeholder for reference docs |
|
|
| `assets/templates/references/sources.md` | Sources provenance template for new skills |
|
|
| `assets/templates/assets/README.md` | Placeholder for static assets |
|
|
| `assets/templates/tests/README.md` | Placeholder for test files |
|
|
| `tests/new-skill.bats` | (source-only) Bats test suite for `scripts/new-skill.sh` |
|
|
| `tests/README.md` | (source-only) Setup instructions for bats-support and bats-assert test dependencies |
|
|
|
|
Rows marked **(source-only)** exist in the authoring source (`.apm/skills/skill-author/`) but are
|
|
not present in an installed plugin: `scripts/sync-plugin-content.sh` strips
|
|
`<category>/<name>/tests` when it generates the flat mirror, because these are dev-time fixtures no
|
|
plugin host needs to discover (ADR-0017). Run them from a repo checkout, not from an install. The
|
|
`assets/templates/tests/README.md` row above is **not** source-only — the exclusion is depth-scoped
|
|
to `<category>/<name>/tests`, so the scaffolding template tree ships intact, which
|
|
`scripts/new-skill.sh` depends on at runtime.
|
|
|
|
## Spec reference
|
|
|
|
[agentskills.io specification](https://agentskills.io/specification.md)
|