Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
Back to list

Run History Skill Builder

A meta-skill that converts real run history into a reusable skill package or a reviewed skill-design plan.

UtilitiesIntermediate69256AI 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

  1. "Turn today's deploy-failure fix into a skill" → a single skill package with validation gates and recovery steps.
  2. "Don't write files yet, just review the design" → plan_only output covering structure, trigger boundaries, and omissions.
  3. "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)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Download 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.

  1. Open a terminal.
  2. Clone the repo: git clone https://github.com/dongshuyan/compass-skills.git
  3. Create the skills folder: mkdir -p ~/.claude/skills
  4. Copy the skill: cp -r compass-skills/skills/run-history-skill-builder ~/.claude/skills/
  5. Confirm the references/, scripts/, and evals/ subfolders came along — the workflow depends on them.
  6. Make sure Python is available (python3 --version) so the package validator can run.
  7. Restart Claude Code and ask something like "build a new skill from what we just did" to trigger it.