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

by woocommerce in woocommerce/woocommerce-ios

Debug a failing test or build error in WooCommerce iOS. An agent skill from woocommerce/woocommerce-ios.

GPL-2.0Auto-check: notesTesting & QA

Install Debug

skills CLI
$ npx skills add woocommerce/woocommerce-ios --skill debug -a claude-code

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

GitHub CLI
$ gh skill install woocommerce/woocommerce-ios debug --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/woocommerce/woocommerce-ios.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/debug .claude/skills/debug && 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
GitHub stars
358
Token cost
~539 tokens
SKILL.md length
222 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
GPL-2.0

At a glance

Debug a failing test or build error in WooCommerce iOS. An agent skill from woocommerce/woocommerce-ios.

  • Works in 5 steps: Run the build and capture errors → Identify the failing file and error type → Read the failing file and surrounding… → …
  • Tasks that involve Failing and flaky tests
  • SKILL.md covers For Build Failures and For Test Failures
  • Calls bundle, xcodebuild and xcrun

What it does

Debug is an agent skill from woocommerce/woocommerce-ios. Debug a failing test or build error in WooCommerce iOS

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Failing and flaky tests. It works with WooCommerce and iOS. The licence is GPL-2.0.

When your agent uses it

  • Tasks that involve Failing and flaky tests

Example prompts

  • “/debug”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob

Workflow steps

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

  1. Run the build and capture errors
  2. Identify the failing file and error type
  3. Read the failing file and surrounding context
  4. Common root causes in this codebase
  5. Propose or apply the fix

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bundle
    • xcodebuild
    • xcrun

    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

Debug loads about 539 tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 222 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep, Glob

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 woocommerce/woocommerce-ios at commit b061662, republished under its GPL-2.0 licence (© woocommerce). 222 words, ~539 tokens.

Download SKILL.mdSave it as .claude/skills/debug/SKILL.md (or your agent's skills folder).
name
debug
description
Debug a failing test or build error in WooCommerce iOS
allowed-tools
Bash, Read, Grep, Glob
user-invocable
true
argument-hint
[test class/method or error description]

Debug a build failure or test failure in the WooCommerce iOS project.

For Build Failures

  1. Run the build and capture errors:
bash
bundle exec fastlane build_for_testing 2>&1 \
  | grep -E "error:|fatal|cannot find|undefined|ambiguous" | head -30
  1. Identify the failing file and error type
  2. Read the failing file and surrounding context
  3. Common root causes in this codebase:
    • Missing module: Check Modules/Package.swift target dependencies
    • Type mismatch: A Networking model changed — check if Yosemite/Storage need updates
    • Cannot find type: May need bundle exec rake generate after adding GeneratedCopiable/Fakeable
    • Ambiguous reference: Duplicate type names across Networking vs Storage
    • CoreData model errors: Check Storage/CoreData/ model versions
  4. Propose or apply the fix

For Test Failures

  1. Run the specific failing test (targeted tests require xcodebuild directly):
bash
xcodebuild -workspace WooCommerce.xcworkspace -scheme WooCommerce \
  -destination 'platform=iOS Simulator,name=iPhone 16' \
  test \
  -only-testing:"<target>/<class>/<method>" 2>&1 | tail -50
  1. Read the test file and understand what it expects
  2. Read the implementation file being tested
  3. Check the mock class setup
  4. Common test failure patterns:
    • Assertion mismatch: Verify expected vs actual, check mock stub values
    • Async timeout: Check if mock callbacks are being invoked, verify continuation setup
    • Nil unwrap: Check if mock return values are configured
    • Wrong mock state: Verify spy properties are set correctly
    • CoreData errors: Ensure InMemoryStorage is used, not persistent storage
    • Missing @MainActor: Some tests need MainActor annotation
  5. Propose or apply the fix

If the simulator destination fails, run xcrun simctl list devices available to discover available simulators, then re-run with a matching device name.

© woocommerce, GPL-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

Just SKILL.md in .claude/skills/debug of woocommerce/woocommerce-ios.

Open the folder on GitHubat commit b061662

Compare with similar skills

Debug 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug this skillwoocommerce/woocommerce-ios358—~539Automated safety check: NotesGPL-2.0
Macios CI Failure Inspectordotnet/macios2.9k—~2.3kAutomated safety check: PassCustom licence
Codex Local CLI E2Erebornix/Agmente545—~625Automated safety check: PassMIT
Fix Random CI Test Failuredotnet/macios2.9k—~1.3kAutomated safety check: PassCustom licence
Diagnosing Bugsgetsentry/sentry-react-native1.8k—~1.4kAutomated safety check: PassMIT
Fixing Flaky Testsbitwarden/ios694—~2.3kAutomated safety check: PassGPL-3.0

Similar skills

  • Macios CI Failure Inspector

    dotnet/macios

    Official

    Investigate and triage CI failures for dotnet/macios from Azure DevOps build URLs.

    2.9k GitHub stars~2.3k tokensUpdated today
    Testing & QAAuto-check passed

  • Codex Local CLI E2E

    rebornix/Agmente

    Run and debug Agmente iOS end-to-end tests against a real local Codex CLI app-server instance.

    545 GitHub stars~625 tokensUpdated 4 mo ago
    Testing & QAAuto-check passed

  • Fix Random CI Test Failure

    dotnet/macios

    Official

    Investigate and fix flaky/random CI test failures in dotnet/macios.

    2.9k GitHub stars~1.3k tokensUpdated today
    Testing & QAAuto-check passed

  • Diagnosing Bugs

    getsentry/sentry-react-native

    Official

    A discipline for hard bugs, flaky tests, CI hangs, native crashes, and performance regressions in this SDK.

    1.8k GitHub stars~1.4k tokensUpdated today
    Testing & QAAuto-check passed

  • Fixing Flaky Tests

    bitwarden/ios

    Official

    Diagnose and fix flaky (intermittently failing) tests in Bitwarden iOS.

    694 GitHub stars~2.3k tokensUpdated yesterday
    Testing & QAAuto-check passed

  • MAUI UI Test Writer

    dotnet/maui

    Official

    Writes UI tests that reproduce a GitHub issue in .NET MAUI and keeps iterating until the tests actually fail, proving they catch the bug.

    23k GitHub stars~3k tokensUpdated today
    Testing & QAAuto-check passed

More from woocommerce/woocommerce-ios

All 12 skills in this repo

  • Auto Login

    woocommerce/woocommerce-ios

    Launch the WooCommerce app on a simulator already authenticated into a given store (site credentials, application password, or WPCom), skipping the manual login UI.

    358 GitHub stars~1.3k tokensUpdated today
    Auto-check: notes

  • Setup Context A8c

    woocommerce/woocommerce-ios

    Set up the ContextA8C MCP server for accessing Automattic internal resources (Slack, Linear, P2s, GitHub Enterprise, etc.)

    358 GitHub stars~627 tokensUpdated today
    Auto-check: notes

  • Snapshot

    woocommerce/woocommerce-ios

    Use swift-snapshot-testing to visually verify SwiftUI views during implementation.

    358 GitHub stars~1.8k tokensUpdated today
    Auto-check: notes

  • Woo AI Smoke

    woocommerce/woocommerce-ios

    Evaluate WooAIAssistant against a structured scenario suite with hard invariants + LLM-as-judge rubric scoring.

    358 GitHub starsUsed in 1 repo~7.4k tokens
    Auto-check: notes

  • Verify

    woocommerce/woocommerce-ios

    Build the app, launch on simulator, and verify feature behavior via mobile-mcp interaction.

    358 GitHub stars~1.2k tokensUpdated today
    Auto-check: notes

  • Mocks

    woocommerce/woocommerce-ios

    Start or stop the WireMock API mock server for UI testing and E2E verification.

    358 GitHub stars~291 tokensUpdated today
    Auto-check: notes

Works with

Categories

Questions about Debug

What does Debug do?

Debug a failing test or build error in WooCommerce iOS. An agent skill from woocommerce/woocommerce-ios. Debug is an agent skill from woocommerce/woocommerce-ios.

When should I use Debug?

Debug fits situations like: tasks that involve Failing and flaky tests.

How do I install Debug in Claude Code?

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

How do I install Debug in Codex?

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

Can I use Debug 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 woocommerce/woocommerce-ios --skill debug -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, .gemini/skills/debug, .github/skills/debug and .opencode/skills/debug in your project.

What does Debug need to run?

Going by SKILL.md and its folder, Debug needs the command-line tools its instructions call (bundle, xcodebuild and xcrun). Its frontmatter pre-approves these tools: Bash, Read, Grep, Glob.

Does Debug 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 Debug safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Debug use?

Debug is published under the GPL-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 use?

About 539 tokens (SKILL.md is roughly 2.2k 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?

Skills that share tags, products or a category with Debug: Macios CI Failure Inspector (dotnet/macios, 2.9k stars), Codex Local CLI E2E (rebornix/Agmente, 545 stars), Fix Random CI Test Failure (dotnet/macios, 2.9k stars) and Diagnosing Bugs (getsentry/sentry-react-native, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debug?

woocommerce (a GitHub organization) maintains it in woocommerce/woocommerce-ios, which has 358 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 7, 2026.

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