Defame1297
70210d6a7e
factory-audit gains three Step 0 rows and flows for the apm primitives
that have no container of their own: a .json file under hooks/, a
*.instructions.md and a *.prompt.md. apm validates almost none of them
(invalid hook JSON is skipped silently, instruction validate() only
warns, input: names are never checked against ${input:x}), so the
deterministic checks live in a new scripts/lib-checks-primitive.sh,
wired into validate.sh's path-shape detection. Each check and tier
traces to the Authoring checklists in the microsoft-apm research docs.
- Hook: JSON/shape/event-list checks mirroring the Copilot payload
validator, never-firing event casing, missing/escaping/non-executable
scripts (FAIL); deprecated filename routing and ${CLAUDE_PLUGIN_ROOT}
(SUGGESTION).
- Instruction: location, frontmatter, description, body, stem clash
(FAIL); missing or list applyTo and unread keys (SUGGESTION).
- Prompt: location/name, frontmatter, description, input names, the
upstream `- name: x` docs bug, declared-vs-used ${input:x} (FAIL);
ADR-0029 description length and trigger clause, dropped keys,
camelCase aliases, argument-hint with input (SUGGESTION). Whether a
prompt carries procedure is judgment in prompt-flow.md, not a script
heuristic.
Vale now lints *.instructions.md and *.prompt.md with the Kyberforge
style; test-vale-wrap.sh gains their probe rows. New
tests/validate-primitive.bats (31 cases). kyberforge 2.0.1 -> 2.1.0 with
the executables.allow key, catalog 0.5.1 -> 0.5.2, marketplace.json
regenerated.
Refs #94
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KkT7RSDwDbmrM9T34b6sTi
11 KiB
11 KiB
source_keys
| source_keys | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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, references/skill-flow.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/skill-flow.md, references/skill-body-discipline.md, references/skill-description-quality.md, references/skill-patterns.md, references/skill-file-structure.md, references/skill-formatting-and-scripts.md, references/skill-finding-criteria.md, references/skill-validation-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/skill-flow.md, references/skill-body-discipline.md, references/skill-patterns.md, references/skill-finding-criteria.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/skill-flow.md, references/skill-description-quality.md, references/skill-finding-criteria.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/skill-flow.md, references/skill-formatting-and-scripts.md, references/skill-finding-criteria.md, references/skill-validation-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
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/agent-flow.md, references/agent-finding-criteria.md, references/agent-field-inventory.md, references/agent-description-quality.md, references/agent-body-and-delegation.md, references/agent-scope-project-user.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/agent-flow.md, references/agent-finding-criteria.md, references/agent-field-inventory.md, references/agent-body-and-delegation.md, references/agent-scope-plugin-apm.md, references/agent-validation-scripts.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/agent-flow.md, references/agent-finding-criteria.md, references/agent-field-inventory.md, references/agent-description-quality.md, references/agent-body-and-delegation.md, references/agent-scope-plugin-apm.md, references/agent-scope-project-user.md, references/agent-validation-scripts.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: SKILL.md, references/agent-flow.md, references/agent-finding-criteria.md, references/agent-field-inventory.md, references/agent-description-quality.md, references/agent-body-and-delegation.md, references/agent-scope-project-user.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: SKILL.md, references/agent-flow.md, references/agent-finding-criteria.md, references/agent-field-inventory.md, references/agent-description-quality.md, references/agent-body-and-delegation.md, references/agent-scope-plugin-apm.md, references/agent-scope-project-user.md, references/agent-validation-scripts.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: (none)
- 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: (none)
- 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
apm-cli-installed-source
- URL: file:///root/.local/pipx/venvs/apm-cli/lib/python3.11/site-packages/apm_cli/
- Research doc: plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md
- Description: Installed apm-cli 0.28.0 source — ground truth for what apm deploys from a hook, instruction or prompt file and what it silently skips, warns on, or fails the install for; every deterministic check in
scripts/lib-checks-primitive.shtraces to it via the research docs' Authoring checklists - Contributing files: SKILL.md, references/hook-flow.md, references/instruction-flow.md, references/prompt-flow.md
- Status:
extracted
apm-docs-llms-full
- URL: https://microsoft.github.io/apm/llms-full.txt
- Research doc: plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md
- Description: Published apm docs bundle — the "Hooks and commands", "Instructions and agents" and "Author a prompt" guides: canonical hook shape and
${PLUGIN_ROOT}, reach narrowed bytargets:rather than filename routing, and "reach for a skill, instruction, or prompt first" - Contributing files: SKILL.md, references/hook-flow.md, references/instruction-flow.md, references/prompt-flow.md
- Status:
extracted