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

Run History Skill Builder

A meta-skill that turns a finished task, log trail, or refined workflow into a validated, reusable skill package.

Dev & CodingIntermediate★ 748⑂ 61AI score 8/10Last updated: Aug 26, 2026

What it does

  • Mines reusable workflows out of real run history: conversation turns, logs, artifacts, diffs, browser flows, failure-and-recovery traces.
  • Forces an intent lock first — plan_only, new_single_skill, router_skill, skill_suite, or a handoff to the upgrader skill.
  • Separates reusable invariants from local accidentals (one-time paths, account names, temporary preferences) so the output is portable across agent hosts.
  • Packages the smallest correct structure across SKILL.md, references/, scripts/, evals/, then runs the bundled scripts/validate_skill_package.py for structure, frontmatter, path and private-leak checks.
  • Includes an evidence-scope gate: credentials, cookies, session archives and unrelated private folders require explicit approval.

Who it's for

  • Developers and prompt engineers who author and maintain agent skills (Claude Code, Codex, OpenCode, etc.).
  • Tech leads standardizing repeated team workflows into shared assets.
  • Anyone who wants a reviewed design plan before any files get written.

Examples

  1. "Turn the deployment debugging session we just finished into a skill" → failures become explicit validation gates in a new single-skill package.
  2. "Give me the design only, don't write files yet" → a plan_only audit with package type, omissions, and open assumptions.
  3. "I want to improve an existing skill" → it refuses to edit in place and produces a clean upgrader handoff instead.

· · · 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.
  6. Restart Claude Code and try: "build a new skill from what we just did".
  7. Python 3 is required for the validator: python3 ~/.claude/skills/run-history-skill-builder/scripts/validate_skill_package.py <target-skill-dir>
View source on GitHub ↗License: MIT