skill revision before/after sample review
Procedure for when revising a self-made skill: generate sample artifacts before and after the revision with two independent workers, so the user can visually check only the differences caused by the skill revision.
Boundaries with other skills
| skill |
Relationship |
skill-creator |
eval / benchmark in general. This skill specializes in the before/after sample review procedure and does not require a full eval loop |
kf-g-skill-authoring-body-structure-rules |
Body structure and affirmative-form procedure. This skill only covers sample generation and review requests |
kf-g-skill-naming-creation-organization-rules |
Naming and placement. Referenced during revision but not the source of truth |
| The PR that newly establishes this skill |
Full dogfooding of this meta skill itself is not required |
Minimal application procedure
- Fix the target skill, revision intent, and review perspective
- procedure.md satisfy the start conditions of
- Take a snapshot of the skill before revision
- sample-artifact-selection.md fix one set of artifact type and common input with
- fixed-prompt-template.md finalize the fixed prompt with
- Launch two independent workers in parallel in the same turn, and collect the before / after artifacts
- review-request.md Request review from the user in the format of
- Finalize the skill revision after approval (do not finalize without approval)
references table of contents
| File |
Reference start conditions |
| procedure.md |
Start conditions, snapshot, fixed conditions, parallel launch, artifact collection, after-only regeneration after revision instructions, finalization after approval |
| sample-artifact-selection.md |
How to choose the artifact type according to the target skill, and fixing the same target content |
| isolation-and-invariants.md |
Independent subagents, prohibitions, and the rule for listing skills when delegating |
| review-request.md |
Review request format for the user (before/after juxtaposition, how to read the differences, waiting for approval) |
| fixed-prompt-template.md |
Fixed prompt template (source of truth with placeholders) |
Invariants
- Do not pass the pre-revision skill and the post-revision skill to the same subagent
- 1 worker = only 1 skill version
- Unify the prompt, input, and artifact type between before / after, and make the differences come only from the skill revision
- In the revision instruction cycle,
before/ is maintained, and with a new Worker B, only after/ is regenerated
Final check
- Two independent workers are launched in parallel with the same fixed prompt
- The before / after artifacts are
artifacts/skill-modification-review/<target-skill>/<timestamp>/{before,after}/ saved in (do not Git commit)
- The skill has not been finalized before user approval
- The review request is review-request.md in line with the format of
