Agent skill

Async Debugging

by revfactory in revfactory/claude-code-harness

Analyze and fix race conditions and concurrency bugs in async code.

No licenceAuto-check passedDevelopment

Install Async Debugging

skills CLI
$ npx skills add revfactory/claude-code-harness --skill async-debugging -a claude-code

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

GitHub CLI
$ gh skill install revfactory/claude-code-harness async-debugging --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/revfactory/claude-code-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/experiments/results/case-002/harness/.claude/skills/async-debugging .claude/skills/async-debugging && 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
async-debugging
GitHub stars
120
Token cost
~204 tokens
SKILL.md length
102 words
Files
2 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
None found

At a glance

Analyze and fix race conditions and concurrency bugs in async code.

  • Works in 4 steps: 식별: 코드에서 공유 상태에 대한 비동기 접근을 모두 찾기 → 시나리오 도출: 어떤 타이밍에 문제가 발생하는지 시퀀스 작성 → 영향 평가: 각 버그의 심각도와 발생 가능성 평가 → …
  • Debugging async bugs
  • SKILL.md covers 버그 분석 워크플로우, 수정 원칙 and 수정 전 반드시
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Async Debugging is an agent skill from revfactory/claude-code-harness. Analyze and fix race conditions and concurrency bugs in async code. Use when debugging async bugs, fixing race conditions, resolving concurrency issues, or when shared state is accessed by multiple async operations.

Its SKILL.md is about 200 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/patterns.md`).

It sits in Development, covering Async programming and Debugging.

When your agent uses it

  • Debugging async bugs
  • Fixing race conditions
  • Resolving concurrency issues
  • Shared state is accessed by multiple async operations

Example prompts

  • “/async-debugging”

Workflow steps

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

  1. 식별: 코드에서 공유 상태에 대한 비동기 접근을 모두 찾기
  2. 시나리오 도출: 어떤 타이밍에 문제가 발생하는지 시퀀스 작성
  3. 영향 평가: 각 버그의 심각도와 발생 가능성 평가
  4. 문서화: bug-analysis.md에 분석 결과 기록

What it can do on your machine

Read from SKILL.md and the folder at commit 267005c. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Async Debugging loads about 204 tokens when it runs, and up to ~735 if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 102 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~204
With references · SKILL.md plus every file in references/, read only if the agent opens them
~735

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 102 words (~204 tokens).

name
async-debugging

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in experiments/results/case-002/harness/.claude/skills/async-debugging of revfactory/claude-code-harness.

  • SKILL.md
  • references/patterns.md

Open the folder on GitHubat commit 267005c

Compare with similar skills

Async Debugging 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.

Async Debugging compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Async Debugging this skillrevfactory/claude-code-harness120—~204Automated safety check: PassNone
Go Concurrency Patternswshobson/agents40k8 repos~693Automated safety check: PassMIT
Julessanjay3290/ai-skills4301 repos~2.1kAutomated safety check: PassApache-2.0
Frappe Errors ClientscriptsImpertio-Studio/Frappe_Claude_Skill_Package187—~2.4kAutomated safety check: PassMIT
DebuggerTheDecipherist/claude-code-mastery-project-starter-kit338—~669Automated safety check: NotesMIT
Rust Debuggingmohitmishra786/low-level-dev-skills253—~1.6kAutomated safety check: PassMIT

Similar skills

  • Reference patterns for goroutines, channels, sync primitives and context in Go, covering worker pools, pipelines, graceful shutdown and race-condition debugging.

    40k GitHub starsUsed in 8 repos~693 tokens
    DevelopmentAuto-check passed
  • Jules

    sanjay3290/ai-skills

    Delegate coding tasks to Google Jules AI agent for asynchronous execution.

    430 GitHub starsUsed in 1 repo~2.1k tokens
    DevelopmentAuto-check passed
  • Frappe Errors Clientscripts

    Impertio-Studio/Frappe_Claude_Skill_Package

    A skill your agent uses when debugging or preventing errors in Frappe Client Scripts.

    187 GitHub stars~2.4k tokensUpdated 20 days ago
    DevelopmentAuto-check passed
  • Debugger

    TheDecipherist/claude-code-mastery-project-starter-kit

    Diagnose failures by root cause, not symptom. An agent skill from TheDecipherist/claude-code-mastery-project-starter-kit.

    338 GitHub stars~669 tokensUpdated 3 mo ago
    DevelopmentAuto-check: notes
  • Rust Debugging

    mohitmishra786/low-level-dev-skills

    Rust debugging skill for systems programming. An agent skill from mohitmishra786/low-level-dev-skills.

    253 GitHub stars~1.6k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Replay Oriented Instrumentation

    ArabelaTso/Skills-4-SE

    Instruments programs to record execution information for deterministic replay debugging.

    253 GitHub stars~2.5k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

More from revfactory/claude-code-harness

All 15 skills in this repo
  • Microservice Patterns

    revfactory/claude-code-harness

    Event-driven microservice architecture patterns guide. An agent skill from revfactory/claude-code-harness.

    120 GitHub stars~502 tokensUpdated 7 mo ago
    Auto-check passed
  • Query Engine Design

    revfactory/claude-code-harness

    SQL query engine design and implementation guide. An agent skill from revfactory/claude-code-harness.

    120 GitHub stars~474 tokensUpdated 7 mo ago
    Auto-check passed
  • API Documentation

    revfactory/claude-code-harness

    Write accurate and complete library API documentation. An agent skill from revfactory/claude-code-harness.

    120 GitHub stars~263 tokensUpdated 7 mo ago
    Auto-check passed
  • Crdt Algorithms

    revfactory/claude-code-harness

    CRDT-based real-time collaborative text editor implementation guide.

    120 GitHub stars~375 tokensUpdated 7 mo ago
    Auto-check passed
  • Express API Design

    revfactory/claude-code-harness

    Express.js REST API design and implementation guide. An agent skill from revfactory/claude-code-harness.

    120 GitHub stars~276 tokensUpdated 7 mo ago
    Auto-check passed
  • Interpreter Design

    revfactory/claude-code-harness

    Programming language interpreter design and implementation guide.

    120 GitHub stars~387 tokensUpdated 7 mo ago
    Auto-check passed

Categories

Questions about Async Debugging

What does Async Debugging do?

Analyze and fix race conditions and concurrency bugs in async code. Async Debugging is an agent skill from revfactory/claude-code-harness. Analyze and fix race conditions and concurrency bugs in async code.

When should I use Async Debugging?

Async Debugging fits situations like: debugging async bugs; fixing race conditions; resolving concurrency issues; shared state is accessed by multiple async operations.

How do I install Async Debugging in Claude Code?

Run `npx skills add revfactory/claude-code-harness --skill async-debugging -a claude-code`. Or copy the skill folder (experiments/results/case-002/harness/.claude/skills/async-debugging in revfactory/claude-code-harness) into .claude/skills/async-debugging in your project. Claude Code loads it when a task matches its description.

How do I install Async Debugging in Codex?

Run `npx skills add revfactory/claude-code-harness --skill async-debugging -a codex`. Or copy the skill folder (experiments/results/case-002/harness/.claude/skills/async-debugging in revfactory/claude-code-harness) into .agents/skills/async-debugging in your project. Codex loads it when a task matches its description.

Can I use Async Debugging 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 revfactory/claude-code-harness --skill async-debugging -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/async-debugging, .gemini/skills/async-debugging, .github/skills/async-debugging and .opencode/skills/async-debugging in your project.

What does Async Debugging need to run?

SKILL.md names no scripts, command-line tools or credentials: Async Debugging is instructions for the agent only.

Does Async Debugging access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Async Debugging 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 Async Debugging use?

No licence was found for Async Debugging or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Async Debugging use?

About 204 tokens (SKILL.md is roughly 816 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 531 tokens, read only when the agent opens those files.

What are the alternatives to Async Debugging?

Skills that share tags, products or a category with Async Debugging: Go Concurrency Patterns (wshobson/agents, 40k stars), Jules (sanjay3290/ai-skills, 430 stars), Frappe Errors Clientscripts (Impertio-Studio/Frappe_Claude_Skill_Package, 187 stars) and Debugger (TheDecipherist/claude-code-mastery-project-starter-kit, 338 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Async Debugging?

revfactory (a GitHub user) maintains it in revfactory/claude-code-harness, which has 120 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on March 6, 2026.

Source: revfactory/claude-code-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.