Defame1297
4a5c3c0cff
Skill name+description pairs are preloaded into every session, costing ~6,200 tokens across 39 skills before any skill is invoked. The authoring rules mandated that growth: skill-author:104 and description-quality.md:21 both required padding, while skill-author:102 (the deflating rule) had no FAIL condition behind it. Gates (blocking, no baseline file): - description 250 chars SUGGESTION / 400 FAIL, measured on the folded YAML value - body-only 600 words SUGGESTION / 900 FAIL, independent of the unchanged whole-file 2770-word / 500-line spec backstop - every boundary-clause routing target must resolve to a real skill or agent; catches skill-improve, neuledge-context and gitea-labels - agents take the description gates but deliberately no body gate; a test pins that absence Vale: DescriptionOpener widened to ^This\b, new CompositionNote rule banning architecture notes from descriptions. 10 hits, 0 false positives. Kyberforge's own four skills retrofitted: descriptions 3,364 -> 938 chars (-72%), bodies 8,306 -> 2,487 words (-70%), all via the apm-workflow dispatch pattern. Fixes the skill-improve dangling route and the agent-author misroute to manual review. Also fixes a pre-existing false positive where any line-initial 'read ' was flagged as interactive input, which had already caused two scripts to be rewritten around it. Refs: ADR-0020
60 lines
3.4 KiB
Markdown
60 lines
3.4 KiB
Markdown
# Sources
|
|
|
|
<!-- agentskills.io/llms.txt was used for initial source discovery and is not listed below; it contributed no skill file content directly. -->
|
|
|
|
## 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/body-discipline.md, references/description-quality.md, references/patterns.md, references/file-structure.md, references/formatting-and-scripts.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, references/body-discipline.md, references/patterns.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, references/description-quality.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:** (none — eval workflow not directly informing audit dimensions)
|
|
- **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/formatting-and-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:** (none — creation guide not directly informing audit criteria)
|
|
- **Status:** `extracted`
|