Files
holocron/plugins/kyberforge/skills/skill-author/references/sources.md
Defame1297 f9b22322a1 feat(kyberforge): improve skill-author — duality description, source_keys guidance, pre-audit checklists, version bump conventions
- references/sources.md: add YAML frontmatter with source_keys to fix provenance chain break
- SKILL.md description: make create/improve duality explicit ("Handles both the full create flow ... and the improve flow ...")
- SKILL.md Step 2: add inline metadata.source_keys instruction — fill early, not deferred to Step 5
- SKILL.md Step 6 (create) / Step 5 (improve): add pre-audit manual checklists and version bump conventions (minor for create, patch for improve)
- README.md: correct false claim that the skill bumps plugin manifests; it bumps metadata.version only

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0147vXtL5sP6vorDdqXGJJU9
2026-07-04 11:06:02 +00:00

3.2 KiB

source_keys
source_keys
agentskills-home
agentskills-spec
agentskills-best-practices
agentskills-optimizing-descriptions
agentskills-evaluating-skills
agentskills-using-scripts
agentskills-quickstart

Sources

agentskills-home

  • URL: https://agentskills.io/home.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Agent Skills overview — what it is, why it exists, progressive disclosure model, ecosystem of 35+ implementing tools
  • Contributing files: SKILL.md
  • Status: extracted

agentskills-spec

  • URL: https://agentskills.io/specification.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Complete SKILL.md format specification — frontmatter fields, constraints, body content, optional directories, progressive disclosure levels, file references, validation
  • Contributing files: SKILL.md, references/deployment-modes.md
  • Status: extracted

agentskills-best-practices

  • URL: https://agentskills.io/skill-creation/best-practices.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Best practices for skill creators — starting from real expertise, spending context wisely, calibrating control, instruction patterns (gotchas, templates, checklists, validation loops)
  • Contributing files: SKILL.md
  • Status: extracted

agentskills-optimizing-descriptions

  • URL: https://agentskills.io/skill-creation/optimizing-descriptions.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: How to systematically test and improve skill descriptions for triggering accuracy — eval queries, trigger rate testing, train/validation splits, optimization loop
  • Contributing files: SKILL.md
  • Status: extracted

agentskills-evaluating-skills

  • URL: https://agentskills.io/skill-creation/evaluating-skills.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Eval-driven skill quality improvement — test case design, workspace structure, assertion writing, grading, benchmarking, human review, iteration loop
  • Contributing files: SKILL.md
  • Status: extracted

agentskills-using-scripts

  • URL: https://agentskills.io/skill-creation/using-scripts.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Using scripts in skills — one-off commands, self-contained scripts with inline dependencies, designing scripts for agentic use (no interactive prompts, --help, structured output, idempotency)
  • Contributing files: SKILL.md, references/scripts.md
  • Status: extracted

agentskills-quickstart

  • URL: https://agentskills.io/skill-creation/quickstart.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Step-by-step guide to creating a first skill (roll-dice example), how discovery/activation/execution work in practice
  • Contributing files: SKILL.md
  • Status: extracted