Files

Defame1297 1eb28da207 fix(kyberforge): remove internal mechanics sentence from skill-author description

## Why

The description sentence "Handles both the full create flow (scaffold → fill →
validate) and the improve flow (signals → root cause → edit → audit)." describes
internal mechanics rather than user intent. The surrounding trigger phrases already
cover both create and improve intents, so this sentence adds no triggering value
and violates the description principle of focusing on what the user is trying to
achieve.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0147vXtL5sP6vorDdqXGJJU9

2026-07-04 11:24:05 +00:00

assets/templates

fix(skill-author): resolve audit findings from post-#8 review

2026-06-27 09:33:24 +00:00

references

feat(kyberforge): improve skill-author — duality description, source_keys guidance, pre-audit checklists, version bump conventions

2026-07-04 11:06:02 +00:00

scripts

fix(skill-author): resolve audit findings from post-#8 review

2026-06-27 09:33:24 +00:00

tests

fix(skill-author): resolve skill-audit findings

2026-06-26 21:24:11 +00:00

README.md

feat(kyberforge): improve skill-author — duality description, source_keys guidance, pre-audit checklists, version bump conventions

2026-07-04 11:06:02 +00:00

SKILL.md

fix(kyberforge): remove internal mechanics sentence from skill-author description

2026-07-04 11:24:05 +00:00

README.md

skill-author

Author and refine skills conforming to the 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

Type	Path
Direct (available immediately after install)	`~/.agents/skills/<name>/`
Plugin (installed via marketplace)	`plugins/<plugin>/skills/<name>/`

If the destination is inside a plugin directory, read references/deployment-modes.md — cache isolation rules apply.

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`	Copies annotated templates to the destination to scaffold a new skill
`references/deployment-modes.md`	Plugin vs standalone differences and 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`	Bats test suite for `scripts/new-skill.sh`
`tests/README.md`	Setup instructions for bats-support and bats-assert test dependencies

Spec reference

agentskills.io specification