Files
holocron/plugins/kyberforge/.apm/skills/factory-audit/references/sources.md
Defame1297 5d0f988ed8 fix(kyberforge): resolve PR #144 review and audit round 3
- factory-audit: hook events judged per deployed target after apm's
  rename (Claude/Copilot event sets FAIL, others SUGGESTION); Claude
  plugin layouts accepted as hook sources; interpreter options and
  sh -c strings checked; bats 378 -> 386
- primitive-author: Must 4/5 match the audit; reference hand-back
  points at the right steps; Step 4.2 --target all fallback
- skill-author: new-skill.sh repair only on the template marker line,
  so complete skills stay a no-op; provenance and calibration text
- forge: restore "already named" qualifier; drop false HITL claim
- apm-workflow: token example uses an env var
- docs/hooks.md: the apm-hooks.json sidecar is committed, not ignored

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KkT7RSDwDbmrM9T34b6sTi
2026-09-28 21:32:18 +00:00

13 KiB

source_keys
source_keys
agentskills-home
agentskills-spec
agentskills-best-practices
agentskills-optimizing-descriptions
agentskills-using-scripts
context7-websites-code-claude
claude-code-plugins-docs
claude-code-subagents-docs
context7-github-en-copilot
github-custom-agents-configuration
apm-cli-installed-source
apm-docs-llms-full
adr-0029-prompt-house-rule
claude-code-hooks-reference
github-copilot-hooks-configuration

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

github-plugins-creating

github-plugins-finding-installing

github-plugins-marketplace

github-sdk-custom-agents

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.sh traces 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 by targets: 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

adr-0029-prompt-house-rule

  • URL: docs/adr/0029-prompts-are-thin-user-triggered-steering-messages.md
  • Research doc: none
  • Basis: docs/adr/0029-prompts-are-thin-user-triggered-steering-messages.md
  • Description: The repo's prompt house rule — a prompt is a single-intent, user-triggered steering message with no procedure — and its description contract: one user-facing sentence naming the steered skills, no trigger or boundary clause
  • Contributing files: references/prompt-flow.md
  • Status: extracted

claude-code-hooks-reference

  • URL: https://code.claude.com/docs/en/hooks
  • Research doc: none
  • Basis: plugins/kyberforge/.apm/skills/factory-audit/scripts/lib-checks-primitive.sh (KNOWN_EVENTS, transcribed from the URL on 2026-09-28; the vendored corpus lists Claude's hook events only partially)
  • Description: Claude Code's hook reference — the full list of hook event names Claude fires, which scripts/lib-checks-primitive.sh carries as KNOWN_EVENTS['claude'] to FAIL an event Claude never fires after apm's rename
  • Contributing files: references/hook-flow.md
  • Status: extracted

github-copilot-hooks-configuration

  • URL: https://docs.github.com/en/copilot/reference/hooks-configuration
  • Research doc: none
  • Basis: plugins/kyberforge/docs/research/docs/github-copilot-plugins/configuration.md (the camelCase list; the PascalCase alternative is from the URL, 2026-09-28)
  • Description: GitHub Copilot's hook configuration reference — the camelCase event names Copilot fires and its PascalCase "VS Code compatible" alternative, carried as KNOWN_EVENTS['copilot']
  • Contributing files: references/hook-flow.md
  • Status: extracted