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
5.0 KiB
5.0 KiB
source_keys
| source_keys | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Sources
context7-websites-code-claude
- URL: context7:/websites/code_claude
- Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
- Description: Official Claude Code documentation site indexed by Context7 — plugin manifest schema, subagent definition types, marketplace JSON format, agent markdown file format
- Contributing files: SKILL.md, references/create.md, references/deployment-modes.md, references/plugin-scope.md
- Status:
extracted
claude-code-plugins-docs
- URL: https://code.claude.com/docs/en/plugins
- Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
- Description: Official Claude Code plugin authoring guide — plugin structure, manifest fields, loading methods, skill namespacing, agent activation, marketplace submission
- Contributing files: SKILL.md, references/deployment-modes.md, references/plugin-scope.md
- Status:
extracted
claude-code-subagents-docs
- URL: https://code.claude.com/docs/en/sub-agents
- Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
- Description: Official Claude Code subagent reference — definition format, all frontmatter fields, scope priority, built-in agents, CLI flags, environment variables, known limitations
- Contributing files: SKILL.md, references/create.md, references/improve.md, references/contract.md, references/deployment-modes.md, references/project-user-scope.md
- Status:
extracted
context7-github-en-copilot
- URL: context7:/websites/github_en_copilot
- Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
- Description: Official GitHub Copilot documentation indexed by Context7; covers CLI plugins, custom agents, SDK, and marketplace
- Contributing files: references/deployment-modes.md, references/project-user-scope.md
- Status:
extracted
github-custom-agents-configuration
- URL: https://docs.github.com/en/copilot/reference/custom-agents-configuration
- Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
- Description: Reference for cloud and IDE custom agent definition format — frontmatter fields, tool aliases, MCP server config, secrets interpolation, scoping hierarchy
- Contributing files: references/contract.md, references/deployment-modes.md, references/project-user-scope.md
- Status:
extracted
github-cli-plugin-reference
- URL: https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-plugin-reference
- Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
- Description: Full CLI plugin reference — plugin.json schema, marketplace.json schema, all CLI commands and flags, install specification formats, loading precedence, env vars, LSP config
- Contributing files: references/deployment-modes.md, references/project-user-scope.md
- Status:
extracted
github-plugins-creating
- URL: https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating
- Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
- Description: How-to for creating Copilot CLI plugins — plugin structure, agent and skill authoring, hooks format, MCP config, development lifecycle
- Contributing files: references/create.md
- Status:
extracted
github-plugins-finding-installing
- URL: https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing
- Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
- Description: User-facing guide to discovering and installing CLI plugins — marketplace browsing commands, install/update/uninstall workflow
- Contributing files: (none)
- Status:
extracted
github-plugins-marketplace
- URL: https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace
- Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
- Description: How-to for creating and publishing a plugin marketplace — marketplace.json structure, hosting options, registration commands
- Contributing files: (none)
- Status:
extracted
github-sdk-custom-agents
- URL: https://docs.github.com/en/copilot/how-tos/copilot-sdk/features/custom-agents
- Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
- Description: SDK custom agent API — CustomAgentConfig fields in all five languages, session config, sub-agent lifecycle events, tool scoping, permission handling
- Contributing files: (none)
- Status:
extracted