Files
holocron/plugins/kyberforge/skills
Defame1297 044b2d3f08 fix(kyberforge): fix HOME/git scope-walkup false-FAILs in agent-audit
validate.sh's detect_scope() and validate-provenance.sh's
find_plugin_root() disagreed with new-agent.sh's already-correct,
documented walk-up semantics on three points, each causing validate.sh
to false-FAIL a legitimately-scaffolded project-scope agent pair:

- a marker-less directory walked up into $HOME (no .git/apm.yml of its
  own) was classified as user scope instead of project scope
- the .git-boundary branch returned the walked-to .git location instead
  of the conventional scope root, breaking any <root> that is a
  subdirectory of a larger git-tracked tree (monorepo package dirs)
- the new conventional-root arithmetic introduced to fix the above two
  cases had no guard against non-conventional/hand-placed file paths,
  which could point it at the wrong ancestor

Also adds scripts/check-scope-walkup-sync.sh, a behavioral drift-guard
(per ADR-0014's no-cross-skill-path precedent) that cross-checks the
four independently hand-ported walk-up implementations (validate.sh,
validate-provenance.sh, new-agent.sh, new-skill.sh) against real
fixture scaffolds, wired into .pre-commit-config.yaml at pre-push so
future drift between the ports is caught automatically.

Verified via bash tests/run-tests.sh (13/13) and targeted before/after
reproduction of each bug this closes.
2026-08-12 11:35:23 +00:00
..

skills/

Skills for this plugin. Each skill lives in its own subdirectory:

skills/
  <skill-name>/
    SKILL.md      # required — frontmatter + skill body
    META.md       # required — provenance and audit fields
    references/   # optional — on-demand reference docs
    scripts/      # optional — executable helper scripts
    assets/       # optional — templates, data files, lookup tables

Shared — both Claude Code and GitHub Copilot CLI read skills/<name>/SKILL.md.

To create or improve a skill, run /skill-author in a Claude Code session. To review a skill without modifying it, run /skill-audit. Do not write SKILL.md by hand without following the authoring standard — trigger descriptions and body discipline are required.

Skills

Skill Description
skill-author Create or improve a skill from scratch, audit findings, or inline feedback
skill-audit Audit a skill directory against the agentskills.io spec and produce a findings report
agent-author Author an agent definition file
pc-author Create, add, remove, and configure .pre-commit-config.yaml
pc-run Install, run, autoupdate, and maintain the pre-commit setup
plugin-author (Deprecated — see apm-workflow) Create, update, and release plugin scaffolds for the holocron marketplace
marketplace-author (Deprecated — see apm-workflow) Add, remove, and update plugin entries in the holocron marketplace manifest
apm-install Install or upgrade the apm CLI and set up the agent runtimes it drives (Copilot CLI, Codex, Gemini, generic llm)
apm-workflow Author apm.yml, scaffold an apm package/marketplace, install dependencies, and compile/pack/publish/audit apm content