From 0f725deb617e14c25b0b7edd33810f017c3a5cc2 Mon Sep 17 00:00:00 2001 From: Defame1297 Date: Sat, 27 Jun 2026 15:12:25 +0000 Subject: [PATCH] docs(spec): update overview for agent-author skill ## Why The convention requires living spec files to be updated in the same commit as any behaviour change. Adding agent-author to kyberforge without updating overview.md would leave the spec stale. ## Impact kyberforge plugin entry now accurately reflects its three current skills (skill-author, skill-audit, agent-author) and drops the outdated reference to create-plugin, marketplace-architect, write-skill, and write-eval which are no longer in the plugin. --- Refs: #10 ADR: docs/adr/0015-agent-author-dual-provider-scaffold.md Co-authored-by: Claude Sonnet 4.6 --- docs/spec/overview.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/spec/overview.md b/docs/spec/overview.md index b8e187d..00ea7e4 100644 --- a/docs/spec/overview.md +++ b/docs/spec/overview.md @@ -2,14 +2,14 @@ Current deployed state of this repo — what you get if you run `install.sh` today. Updated at the close of each chunk and in the same PR as any behavior change. -*Last updated: 2026-06-20 (kyberforge plugin — marketplace skill consolidation)* +*Last updated: 2026-06-27 (kyberforge plugin — agent-author skill)* ## What is deployed ### Plugins 1 plugin registered in the marketplace (`holocron` marketplace, `.claude-plugin/marketplace.json`): -- **`kyberforge`** — marketplace management toolkit. Contains `create-plugin`, `marketplace-architect`, `write-skill`, `write-eval` skills plus bundled assets (`assets/plugin-template/`), reference docs, scripts, and evals. Install: `claude plugin install kyberforge@holocron`. Source: `plugins/kyberforge/`. Research doc: `plugins/kyberforge/docs/plugin-marketplace-architecture.md`. +- **`kyberforge`** — marketplace management toolkit and skill/agent factory. Contains `skill-author` (create/improve SKILL.md files), `skill-audit` (validate skills against agentskills.io spec), and `agent-author` (create/improve Claude Code + Copilot CLI agent definition files at plugin, project, or user scope) skills. Install: `claude plugin install kyberforge@holocron`. Source: `plugins/kyberforge/`. Research doc: `plugins/kyberforge/docs/plugin-marketplace-architecture.md`. ### Skills 13 skills deployed directly to `~/.agents/skills/` via `install.sh`. Available as slash commands in Claude Code via `~/.claude/skills/ → ~/.agents/skills/` symlink. Factory and marketplace skills (`write-eval`, `write-skill`, `create-plugin`, `marketplace-architect`) have moved to the `kyberforge` plugin and are only available after plugin install. @@ -53,6 +53,8 @@ For chunk planning and open questions, see `docs/ROADMAP.md`. ## Recent changes +- 2026-06-27 — `agent-author` skill added to kyberforge plugin. Creates and improves agent definition files for both Claude Code (`.md`) and GitHub Copilot CLI (`.agent.md`) from a single root directory input via `new-agent.sh`. Supports plugin, project, and user scope — scope auto-detected from root (`plugin.json` presence). File-by-file no-op scaffold; routing on file existence (neither → create, any exists → improve). `agents/sources.md` for provenance at plugin scope. No companion `agent-audit` skill (deferred, tracked in issue #11). ADR-0015 documents the dual-provider single-root scaffold decision. + - 2026-06-20 — kyberforge plugin created and registered in `holocron` marketplace. Consolidates `create-plugin`, `marketplace-architect`, `write-skill`, and `write-eval` skills (previously in `.agents/skills/`) plus their evals, bundled scripts, references, and the plugin-marketplace-architecture research doc into a single installable plugin at `plugins/kyberforge/`. Plugin template (`templates/plugin/`) bundled into `plugins/kyberforge/skills/create-plugin/assets/plugin-template/` and removed from repo root. Evals moved from `.agents/evals/marketplace/` and `.agents/evals/factory/write-eval/` into `plugins/kyberforge/tests/evals/`. These four skills are no longer available as standalone slash commands — install the plugin to use them. - 2026-06-20 — Gitleaks secret scanning added. `scripts/setup-gitleaks.sh` installs gitleaks v8.24.2, seeds `.gitleaks.toml` (first run only — project-owned after that), and writes a managed pre-commit hook block that is replaced on re-run. `scripts/gitleaks.toml` is the base config template extending gitleaks defaults. `tests/test-setup-gitleaks.sh` covers 6 behaviors (reject non-git dir, config deploy, hook create, append, stale-block replace, idempotency). `.gitleaks.toml` in repo root adds path allowlist for `docs/research/` (high-entropy terminal captures). `gitleaks` skill added (`cross-cutting`) covering full lifecycle: install, update, tune allowlist, scan modes, resolve real findings. Key lesson: v8.24.2 uses `[allowlist]` (singular); v8.25.0+ uses `[[allowlists]]` — wrong syntax silently does nothing.