Install any skill in seconds. Free to start, no credit card required.
Get Started Free →okhp3/okhp3-skill-promotion
Promote and synchronize a project-local Agent Skill into a portable, reviewable distribution package.
Passed 13 of 17 test cases with the skill, and 4 of 17 without it.
and 11 more in the full report
12 fixed5 passed either way6 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
We want to run a dry-run equality check for `.agents/skills/yaml-lint` against `skills/yaml-lint` before mirroring. What exact CLI command line invocation should be run to perform this deterministic package comparison without modifying any files on disk?
| Checked | Without skill | With skill |
|---|---|---|
| Specifies running python scripts/sync_skill_mirror.py --source .agents/skills/yaml-lint --destination skills/yaml-lint --check. | Missed | Passed |
The instructions your model reads when the skill loads.
OverKill Hill P³ · overkillhill.com · github.com/OKHP3
Turn a useful project-local skill into a traceable, portable promotion package without creating competing editable sources or silently publishing project context.
Treat a skill as one identified package with staged representations:
| Surface | Path | Authority while incubating | Purpose |
|---|---|---|---|
| Runtime source | .agents/skills/<name>/ | Originating project | Immediately usable local skill |
| Publication mirror | skills/<name>/ | Generated from runtime source | Portable candidate for review and sharing |
| Canonical distribution | <family>/<name>/ in OKHP3/skillz | Accepted distribution package | Installable public skill |
The runtime source is the editable source while the skill is being developed. The publication mirror is managed output, not a second authoring location. After canonical promotion, the portable core is maintained through an explicit, reviewed update from the canonical package. Project-specific adapters may remain different when the difference is documented.
| In scope | Out of scope |
|---|---|
| Compare candidate copies and select a source using evidence | Choosing a source by timestamp, line count, or version alone |
Create or verify a local skills/<name>/ mirror | Blindly overwriting a divergent mirror |
| Produce a provenance and promotion manifest | Uploading, committing, pushing, or opening a PR without authorization |
| Route to Foundry, catalog, validation, and repository guidance | Treating a passing structural check as proof of task quality |
| Preserve local context and identify public-safety blockers | Guessing whether private material is safe to publish |
Collect these before writing:
test cases passed, vs 4 / 17 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.