Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

feat: implement issue 0018 phase 1 — factory/write-skill bootstrap skill

Browse Source 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Defame1297
2026-05-17 18:24:28 +00:00
parent 83715018eb
commit 58476a96fd
6 changed files with 242 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
docs/issues/0018-factory-write-skill.md
View File

@@ -42,10 +42,10 @@ Follow the per-skill workflow defined in `docs/notes/skill-implementation-workfl
## Acceptance criteria
- [ ] `.agents/skills/write-skill/SKILL.md` exists; `metadata.category: factory`; authoring standard met
- [ ] Trigger description validates against explicit, implicit, and negative test queries
- [ ] `.agents/evals/factory/write-skill/eval.yaml` exists; produced via `write-eval`
- [ ] `install.sh` deploys `write-skill` to `~/.agents/skills/`
- [x] `.agents/skills/write-skill/SKILL.md` exists; `metadata.category: factory`; authoring standard met
- [x] Trigger description validates against explicit, implicit, and negative test queries
- [x] `.agents/evals/factory/write-skill/eval.yaml` exists; produced via `write-eval`
- [x] `install.sh` deploys `write-skill` to `~/.agents/skills/`
- [ ] **HITL:** human runs behavioral test: invoke "write a new skill for X" and verify the produced SKILL.md meets the authoring standard
- [ ] **HITL:** human reviews SKILL.md and eval before committing
- [ ] Per-skill process followed for both phases (see `docs/notes/skill-implementation-workflow.md`)
@@ -61,3 +61,27 @@ Follow the per-skill workflow defined in `docs/notes/skill-implementation-workfl
- 0016 (grill defines per-skill workflow)
- 0017 (`write-eval` needed to produce the eval for this skill)
## Handoff — Phase 1
**Status:** complete — pending HITL behavioral test (acceptance criteria steps 5–6)
**Files produced:**
- `.agents/skills/write-skill/SKILL.md`
- `.agents/evals/factory/write-skill/eval.yaml`
**Key decisions:**
- Scope: new-skill creation + placeholder→canonical conversion only. Updating/fixing existing skills → `upgrade-skill` (separate skill in the index).
- Trigger validation (3 cases) is a named gate in write-skill's process before body content is written.
- `write-eval` is step 7 of write-skill's process — the skill invokes it automatically. HITL prompt is step 8.
- Self-authored (no `source:` field); `references:` cites agentskills.io best-practices and optimizing-descriptions.
- speckit-agent-skills (dceoy) excluded — AGPL-3.0 copyleft.
- Role is self-contained (no reference to workflow doc) so it can be used standalone after chunk 3.
**Open threads:**
- HITL behavioral test: open a fresh session, invoke "write a new skill for X" in this repo context, verify trigger is tested before body, per-section walk-through happens, write-eval is invoked, HITL prompt appears.
- Phase 2 (`write-docs`): first skill authored end-to-end by the factory. Follow full per-skill workflow from `docs/notes/skill-implementation-workflow.md`.
**Next session start:**
- Load: `CONTEXT.md`, `docs/notes/skill-implementation-workflow.md`, `docs/issues/0018-factory-write-skill.md`
- First action: HITL behavioral test for write-skill, then begin phase 2 (`write-docs`) using write-skill