Agent skill

Synnax Integration Debug

by synnaxlabs in synnaxlabs/synnax

Triage failures from the Synnax integration test suite (uv run tc ...).

Custom licenceAuto-check: notesTesting & QA

Install Synnax Integration Debug

skills CLI
$ npx skills add synnaxlabs/synnax --skill synnax-integration-debug -a claude-code

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

GitHub CLI
$ gh skill install synnaxlabs/synnax synnax-integration-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/synnaxlabs/synnax.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/synnax-integration-debug .claude/skills/synnax-integration-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
synnax-integration-debug
GitHub stars
128
Token cost
~2.1k tokens
SKILL.md length
723 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
Custom licence

At a glance

Triage failures from the Synnax integration test suite (uv run tc ...).

  • Works in 4 steps: Extract the run ID from the URL (the… → List the workflow's artifacts and… → cd… → …
  • A console/driver/arc test fails locally
  • SKILL.md covers From a CI failure link, Workflow, Bundle layout and Reading summary.json, plus 4 more sections
  • Calls pnpm, gh and jq

What it does

Synnax Integration Debug is an agent skill from synnaxlabs/synnax. Triage failures from the Synnax integration test suite (uv run tc ...). Use when a console/driver/arc test fails locally, when the user pastes a CI workflow URL for a Test - Integration run, or when they reference a debug bundle, summary.json, trace.zip, or a run-TS/ directory. Walks the bundle in order: summary.json → per-test artifacts → trace inspection → server log.

Its SKILL.md is about 2.1k 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 Integration testing and Debugging. The repository describes itself as: The data and operations foundation for hardware.

When your agent uses it

  • A console/driver/arc test fails locally
  • The user pastes a CI workflow URL for a Test - Integration run
  • They reference a debug bundle
  • A run-TS/ directory

Example prompts

  • “/synnax-integration-debug”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash, Read

Workflow steps

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

  1. Extract the run ID from the URL (the digits after /actions/runs/).
  2. List the workflow's artifacts and download the bundle
  3. cd /tmp/synnax-bundle/test-results-OS-NAME/run-TS-* and proceed with the Workflow
  4. To see the conductor's stdout (including the → bundle: breadcrumb and per-test

What it can do on your machine

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

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm
    • gh
    • jq
    • uv

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, gh and 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

Synnax Integration Debug loads about 2.1k tokens when it runs. Until then it costs about 102 tokens; SKILL.md has 723 words of instructions outside code blocks.

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

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 723 words (~2,056 tokens).

“When the integration test conductor (uv run tc ...) finishes, it writes a self-contained debug bundle to integration/tests/results/run-TS[-NAME]/. A latest symlink in the same dir points at the most recent run. Always start here when triaging an integration failure. The…”

— opening of SKILL.md by synnaxlabs, Custom licence
name
synnax-integration-debug
allowed-tools
Bash, Read

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/synnax-integration-debug of synnaxlabs/synnax.

Open the folder on GitHubat commit a83afc9

Compare with similar skills

Synnax Integration 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.

Synnax Integration Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Synnax Integration Debug this skillsynnaxlabs/synnax128—~2.1kAutomated safety check: NotesCustom licence
Workflow Regression Testspurefunctor/purescript-iris117—~1.8kAutomated safety check: PassCustom licence
Debugging Hanging Testsgolemcloud/golem1.5k—~879Automated safety check: PassCustom licence
Rocky Test Fixturesrocky-data/rocky304—~2.3kAutomated safety check: PassApache-2.0
Plugin Testingpolyipseity/obsidian-terminal950—~828Automated safety check: PassAGPL-3.0
Create Modulecartography-cncf/cartography4.1k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Workflow Regression Tests

    purefunctor/purescript-iris

    Workflow for producing auditable Git or jj history for a known compiler bug fix.

    117 GitHub stars~1.8k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Debugging Hanging Tests

    golemcloud/golem

    Diagnosing and fixing hanging worker executor or integration tests.

    1.5k GitHub stars~879 tokensUpdated today
    Testing & QAAuto-check passed
  • Rocky Test Fixtures

    rocky-data/rocky

    Dagster integration test fixture lifecycle. An agent skill from rocky-data/rocky.

    304 GitHub stars~2.3k tokensUpdated today
    Testing & QAAuto-check passed
  • Plugin Testing

    polyipseity/obsidian-terminal

    Skill for testing Obsidian plugin features in this repository.

    950 GitHub stars~828 tokensUpdated 6 days ago
    Testing & QAAuto-check passed
  • Create Module

    cartography-cncf/cartography

    Author a new Cartography intel module end-to-end (entry point, sync GET/TRANSFORM/LOAD/CLEANUP, declarative data model, integration test, schema docs).

    4.1k GitHub stars~2.5k tokensUpdated today
    Testing & QAAuto-check passed
  • Write integration tests for the td-sync admin API using the TestHarness in internal/api/testharnesstest.go.

    251 GitHub stars~1.2k tokensUpdated 9 days ago
    Testing & QAAuto-check passed

More from synnaxlabs/synnax

All 10 skills in this repo
  • PR Comments

    synnaxlabs/synnax

    Workflow for working through unresolved review comments on a pull request you authored.

    128 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Console Testing

    synnaxlabs/synnax

    Rules for writing and editing unit tests in the Console (console/src//.spec.ts[x]).

    128 GitHub stars~5.4k tokensUpdated yesterday
    Auto-check passed
  • Code Review

    synnaxlabs/synnax

    Process and hard rules for conducting code reviews in this repo: PRs, branches, commit ranges, and working diffs.

    128 GitHub stars~3.7k tokensUpdated yesterday
    Auto-check passed
  • Create Linear Issue

    synnaxlabs/synnax

    Synnax Linear issue conventions. An agent skill from synnaxlabs/synnax.

    128 GitHub stars~846 tokensUpdated yesterday
    Auto-check passed
  • Design

    synnaxlabs/synnax

    Process and hard rules for designing and planning complex new features, refactors, and re-architectures.

    128 GitHub stars~4.5k tokensUpdated yesterday
    Auto-check passed
  • Eb Review

    synnaxlabs/synnax

    Process and hard rules for a fast software quality audit of work this session just produced, or of a solution being proposed before it is built.

    128 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Synnax Integration Debug

What does Synnax Integration Debug do?

Triage failures from the Synnax integration test suite (uv run tc ...). Synnax Integration Debug is an agent skill from synnaxlabs/synnax.).

When should I use Synnax Integration Debug?

Synnax Integration Debug fits situations like: A console/driver/arc test fails locally; the user pastes a CI workflow URL for a Test - Integration run; they reference a debug bundle; A run-TS/ directory.

How do I install Synnax Integration Debug in Claude Code?

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

How do I install Synnax Integration Debug in Codex?

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

Can I use Synnax Integration 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 synnaxlabs/synnax --skill synnax-integration-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/synnax-integration-debug, .gemini/skills/synnax-integration-debug, .github/skills/synnax-integration-debug and .opencode/skills/synnax-integration-debug in your project.

What does Synnax Integration Debug need to run?

Going by SKILL.md and its folder, Synnax Integration Debug needs the command-line tools its instructions call (pnpm, gh, jq and uv). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash, Read.

Does Synnax Integration Debug access the network?

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

Is Synnax Integration 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 Synnax Integration Debug use?

Synnax Integration Debug has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Synnax Integration Debug use?

About 2.1k tokens (SKILL.md is roughly 8.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 Synnax Integration Debug?

Skills that share tags, products or a category with Synnax Integration Debug: Workflow Regression Tests (purefunctor/purescript-iris, 117 stars), Debugging Hanging Tests (golemcloud/golem, 1.5k stars), Rocky Test Fixtures (rocky-data/rocky, 304 stars) and Plugin Testing (polyipseity/obsidian-terminal, 950 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Synnax Integration Debug?

synnaxlabs (a GitHub organization) maintains it in synnaxlabs/synnax, which has 128 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 8, 2026.

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