Run History Skill Builder
A meta-skill that converts real run history into a reusable skill package or a reviewed skill-design plan.
UtilitiesIntermediate★ 692⑂ 56AI score 8/10Last updated: Aug 9, 2026
What it does
Takes a finished task, browser flow, artifact pipeline, or failure-recovery trace and turns it into a packaged, reusable skill instead of a one-off memory.
- Locks intent first:
plan_only, single skill, router skill, skill suite, or handoff to an upgrader - Locks evidence scope; credentials, cookies, session exports and unrelated private folders require explicit approval
- Separates reusable invariants from local accidentals (one-time paths, account names, temporary preferences)
- Builds the smallest package that preserves correctness across SKILL.md,
references/,scripts/,evals/ - Validates via the bundled
scripts/validate_skill_package.py, plus trigger review (3 should-trigger, 3 should-not, 2 boundary) and a secret-leak scan
Who it's for
- Anyone who keeps re-explaining the same workflow and wants it captured as a skill
- Maintainers of a team or org skill repository who need consistent quality bars
- Authors targeting multiple agent hosts (Claude Code, Codex, OpenCode, and similar)
Examples
- "Turn today's deploy-failure fix into a skill" → a single skill package with validation gates and recovery steps.
- "Don't write files yet, just review the design" → plan_only output covering structure, trigger boundaries, and omissions.
- "I want to improve my existing research skill" → no direct edits; it produces a clean handoff for the upgrader skill.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/dongshuyan/compass-skills/HEAD/skills/run-history-skill-builder/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/run-history-skill-builder folder from the GitHub repo dongshuyan/compass-skills into my ~/.claude/skills/run-history-skill-builder/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/dongshuyan/compass-skills.git && mkdir -p ~/.claude/skills && cp -r compass-skills/skills/run-history-skill-builder ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/dongshuyan/compass-skills.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r compass-skills/skills/run-history-skill-builder ~/.claude/skills/ - Confirm the
references/,scripts/, andevals/subfolders came along — the workflow depends on them. - Make sure Python is available (
python3 --version) so the package validator can run. - Restart Claude Code and ask something like "build a new skill from what we just did" to trigger it.
View source on GitHub ↗License: MIT