New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Debug Run

by fl-sean03 in fl-sean03/OpenSDL

Diagnose a failed OpenSDL run, reproduce it in simulation, and validate the smallest correct fix.

Apache-2.0Auto-check passedAgent Workflows

Install Debug Run

skills CLI
$ npx skills add fl-sean03/OpenSDL --skill debug-run -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fl-sean03/OpenSDL debug-run --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fl-sean03/OpenSDL.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/debug-run .claude/skills/debug-run && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
debug-run
GitHub stars
107
Token cost
~438 tokens
SKILL.md length
229 words
Files
2
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

Diagnose a failed OpenSDL run, reproduce it in simulation, and validate the smallest correct fix.

  • Works in 9 steps: Run .agents/skills/debug-run/run.sh… → Run uv run --locked opensdl events… → Trace the policy decision, lease,… → …
  • Task has failed
  • SKILL.md covers Inputs, Procedure, Completion and Stop conditions
  • Runs Shell scripts from its folder; calls uv

What it does

Debug Run is an agent skill from fl-sean03/OpenSDL. Diagnose a failed OpenSDL run, reproduce it in simulation, and validate the smallest correct fix. Use when a workflow or task has failed or requires intervention.

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `run.sh`).

It sits in Agent Workflows. The repository describes itself as: A modular Python foundation for reproducible computational and autonomous laboratories. Alpha; the reference profile is simulator-only. The licence is Apache-2.0.

When your agent uses it

  • Task has failed
  • Requires intervention

Example prompts

  • “/debug-run”

Requirements

  • A Bash shell

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Run .agents/skills/debug-run/run.sh RUN_ID [MANIFEST].
  2. Run uv run --locked opensdl events --manifest MANIFEST --run-id RUN_ID and identify the first
  3. Trace the policy decision, lease, adapter call, timeout, retry, and error events.
  4. Reproduce with a simulation manifest when the workflow and inputs are available.
  5. Fix the smallest correct contract, adapter, runtime, storage, or configuration layer.
  6. Add a regression test and a conformance case when an adapter contract changed.
  7. Re-run the simulation and export it with uv run --locked opensdl export RUN_ID --manifest MANIFEST.
  8. Submit a repaired workflow as a new run with opensdl run WORKFLOW --supersedes RUN_ID. A run
  9. Check propagation impact before completion.

What it can do on your machine

Read from SKILL.md and the folder at commit 43f4988. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Debug Run loads about 438 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 229 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~438

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from fl-sean03/OpenSDL at commit 43f4988, republished under its Apache-2.0 licence (© fl-sean03). 229 words, ~438 tokens.

Download SKILL.mdSave it as .claude/skills/debug-run/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
debug-run
description
Diagnose a failed OpenSDL run, reproduce it in simulation, and validate the smallest correct fix. Use when a workflow or task has failed or requires intervention.

Debug a failed run

Inputs

  • persisted run identifier
  • manifest path
  • workflow and inputs when a simulation reproduction is possible

Procedure

  1. Run .agents/skills/debug-run/run.sh RUN_ID [MANIFEST].
  2. Run uv run --locked opensdl events --manifest MANIFEST --run-id RUN_ID and identify the first failed task.
  3. Trace the policy decision, lease, adapter call, timeout, retry, and error events.
  4. Reproduce with a simulation manifest when the workflow and inputs are available.
  5. Fix the smallest correct contract, adapter, runtime, storage, or configuration layer.
  6. Add a regression test and a conformance case when an adapter contract changed.
  7. Re-run the simulation and export it with uv run --locked opensdl export RUN_ID --manifest MANIFEST.
  8. Submit a repaired workflow as a new run with opensdl run WORKFLOW --supersedes RUN_ID. A run records the workflow it was asked to execute, so --run-id RUN_ID resumes only the identical definition and is refused for any other; superseding leaves the failed run's record intact and names the replacement on both.
  9. Check propagation impact before completion.

Completion

The cause is tied to persisted evidence, the regression test fails before the fix and passes after it, and the simulation rerun has an exported evidence bundle.

Stop conditions

Stop on ambiguous physical state or when safe recovery needs hold, abort, resume, or reconciliation behavior that the typed interface does not expose. Do not infer physical reversal from database state.

© fl-sean03, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/debug-run of fl-sean03/OpenSDL.

  • SKILL.md
  • run.sh

Open the folder on GitHubat commit 43f4988

Compare with similar skills

Debug Run next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Debug Run compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug Run this skillfl-sean03/OpenSDL107—~438Automated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k62 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official37k11 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k34 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers296k2 repos~5.1kAutomated safety check: PassMIT
Claude Code Agent Developmentanthropics/claude-plugins-official37k8 repos~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 62 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    37k GitHub starsUsed in 11 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes

  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 34 repos~1.4k tokens
    Agent WorkflowsAuto-check passed

  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    296k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed

  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    37k GitHub starsUsed in 8 repos~2.8k tokens
    Agent WorkflowsAuto-check passed

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    794 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed

More from fl-sean03/OpenSDL

All 11 skills in this repo

  • Author Skill

    fl-sean03/OpenSDL

    Create, revise, split, or remove an OpenSDL repository skill.

    107 GitHub stars~440 tokensUpdated 3 days ago
    Auto-check passed

  • Create Lab

    fl-sean03/OpenSDL

    Create a simulator-first organization laboratory scaffold with policy and validation.

    107 GitHub stars~441 tokensUpdated 3 days ago
    Auto-check passed

  • Design Lab

    fl-sean03/OpenSDL

    Scope the physical and interface design of a laboratory before configuring it.

    107 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed

  • Develop Workflow

    fl-sean03/OpenSDL

    Design, change, validate, and test an OpenSDL workflow through a simulation manifest.

    107 GitHub stars~462 tokensUpdated 3 days ago
    Auto-check passed

  • Orient Lab

    fl-sean03/OpenSDL

    Inspect the current OpenSDL repository and declared laboratory state.

    107 GitHub stars~534 tokensUpdated 3 days ago
    Auto-check passed

  • Release

    fl-sean03/OpenSDL

    Build and validate OpenSDL release candidates by synchronizing versions and producing every workspace distribution locally.

    107 GitHub stars~580 tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Debug Run

What does Debug Run do?

Diagnose a failed OpenSDL run, reproduce it in simulation, and validate the smallest correct fix. Debug Run is an agent skill from fl-sean03/OpenSDL. Diagnose a failed OpenSDL run, reproduce it in simulation, and validate the smallest correct fix.

When should I use Debug Run?

Debug Run fits situations like: task has failed; requires intervention.

How do I install Debug Run in Claude Code?

Run `npx skills add fl-sean03/OpenSDL --skill debug-run -a claude-code`. Or copy the skill folder (.agents/skills/debug-run in fl-sean03/OpenSDL) into .claude/skills/debug-run in your project. Claude Code loads it when a task matches its description.

How do I install Debug Run in Codex?

Run `npx skills add fl-sean03/OpenSDL --skill debug-run -a codex`. Or copy the skill folder (.agents/skills/debug-run in fl-sean03/OpenSDL) into .agents/skills/debug-run in your project. Codex loads it when a task matches its description.

Can I use Debug Run in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fl-sean03/OpenSDL --skill debug-run -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debug-run, .gemini/skills/debug-run, .github/skills/debug-run and .opencode/skills/debug-run in your project.

What does Debug Run need to run?

Going by SKILL.md and its folder, Debug Run needs a shell for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: A Bash shell.

Does Debug Run access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Debug Run safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Debug Run use?

Debug Run is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Debug Run use?

About 438 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Debug Run?

Skills that share tags, products or a category with Debug Run: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 37k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 296k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debug Run?

fl-sean03 (a GitHub user) maintains it in fl-sean03/OpenSDL, which has 107 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 4, 2026.

Source: fl-sean03/OpenSDL on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.