Agent skill

Debug Flydsl Kernel

by ROCm in ROCm/FlyDSL

Debug FlyDSL GPU kernels that produce NaN, inf, wrong results, or crash.

Custom licenceAuto-check: notesAI & LLM Engineering

Install Debug Flydsl Kernel

skills CLI
$ npx skills add ROCm/FlyDSL --skill debug-flydsl-kernel -a claude-code

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

GitHub CLI
$ gh skill install ROCm/FlyDSL debug-flydsl-kernel --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/ROCm/FlyDSL.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/debug-flydsl-kernel .claude/skills/debug-flydsl-kernel && 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-flydsl-kernel
GitHub stars
287
Token cost
~2.6k tokens
SKILL.md length
877 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
Custom licence

At a glance

Debug FlyDSL GPU kernels that produce NaN, inf, wrong results, or crash.

  • Works in 10 steps: Clear All Caches (ALWAYS DO THIS FIRST) → Classify the Error → Debugging NaN → …
  • A FlyDSL kernel produces incorrect output
  • SKILL.md covers Step 0: Clear All Caches…, Step 1: Classify the Error, 2. Debugging NaN and 3. Debugging All-Zeros Output, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Debug Flydsl Kernel is an agent skill from ROCm/FlyDSL. Debug FlyDSL GPU kernels that produce NaN, inf, wrong results, or crash. Covers cache invalidation, tracing pitfalls (runtime conditionals, range vs rangeconstexpr), loop-carried state packing, bufferload addressing, MFMA operand layout verification, LDS bank conflict diagnosis, and systematic error isolation (all-1s test, single-partition test, host-side tensor inspection). Use when a FlyDSL kernel produces incorrect output or compilation errors. Usage: /debug-flydsl-kernel

Its SKILL.md is about 2.6k 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 AI & LLM Engineering, covering Caching and Debugging. The repository describes itself as: FlyDSL is the Python front‑end of the project: a Flexible Layout Python DSL for expressing tiling, partitioning, data movement, and kernel structure at a high level.

When your agent uses it

  • A FlyDSL kernel produces incorrect output
  • Compilation errors

Example prompts

  • “/debug-flydsl-kernel”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Edit, Bash, Grep, Glob, Agent

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Clear All Caches (ALWAYS DO THIS FIRST)
  2. Classify the Error
  3. Debugging NaN
  4. Debugging All-Zeros Output
  5. Debugging Large Mismatch (>50%)
  6. Debugging Small Errors (1-5%)
  7. Compilation Errors
  8. GPU Hang
  9. Diagnostic Workflow
  10. Common Pitfalls Checklist

What it can do on your machine

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

    • Read
    • Edit
    • Bash
    • Grep
    • Glob
    • Agent

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python and bash).

    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 Flydsl Kernel loads about 2.6k tokens when it runs. Until then it costs about 125 tokens; SKILL.md has 877 words of instructions outside code blocks.

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

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.

  • NoteRuns commands with sudoSKILL.md:252
    sudo amd-smi reset -G -g <gpu_index>
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Edit, Bash, Grep, Glob, Agent

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 877 words (~2,559 tokens).

“FlyDSL aggressively caches compiled kernels. Stale cache is the #1 cause of "my fix didn't work":”

— opening of SKILL.md by ROCm, Custom licence
name
debug-flydsl-kernel
allowed-tools
Read, Edit, Bash, Grep, Glob, Agent

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/debug-flydsl-kernel of ROCm/FlyDSL.

Open the folder on GitHubat commit 1941889

Compare with similar skills

Debug Flydsl Kernel 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 Flydsl Kernel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug Flydsl Kernel this skillROCm/FlyDSL287—~2.6kAutomated safety check: NotesCustom licence
Native Data FetchingCherryHQ/cherry-studio-app4k6 repos~2.9kAutomated safety check: NotesMIT
Keybase RPC Log Analysiskeybase/client9.3k—~3kAutomated safety check: PassBSD-3-Clause
ML Failure DebuggerLeeroo-AI/superml195—~9.5kAutomated safety check: PassApache-2.0
Flowfile Debugging PlaybookEdwardvaneechoud/Flowfile370—~6.3kAutomated safety check: PassMIT
Writing Streamlit AppsPostHog/posthog-foss721—~1.5kAutomated safety check: PassMIT

Similar skills

  • Native Data Fetching

    CherryHQ/cherry-studio-app

    A skill your agent uses when implementing or debugging ANY network request, API call, or data fetching.

    4k GitHub starsUsed in 6 repos~2.9k tokens
    DevelopmentAuto-check: notes
  • Captures a clean Keybase service log and analyzes it for redundant, duplicated or looping RPCs, then checks whether a caching fix reduced the calls.

    9.3k GitHub stars~3k tokensUpdated today
    DevelopmentAuto-check passed
  • ML Failure Debugger

    Leeroo-AI/superml

    Diagnoses failing ML and AI work, such as OOM, NaN, divergence, crashes, slow throughput, wrong outputs and dependency conflicts, with every claim backed by documentation citations.

    195 GitHub stars~9.5k tokensUpdated 6 mo ago
    AI & LLM EngineeringAuto-check passed
  • Flowfile Debugging Playbook

    Edwardvaneechoud/Flowfile

    Symptom-to-cause triage playbook for Flowfile (core/worker/kernel/frontend/AI) — covers "no such table" DB cascades (two distinct causes), import-time Alembic migration corruption, silent…

    370 GitHub stars~6.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Writing Streamlit Apps

    PostHog/posthog-foss

    Official

    Write Streamlit app source code that runs well in a PostHog sandbox — the posthogapps.query() bridge for reading PostHog data, the packages baked into the sandbox image, caching and session state…

    721 GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Authoring CI Workflows

    PostHog/posthog-foss

    Official

    A skill your agent uses when adding or editing a GitHub Actions workflow, composite action, or reusable workflow under .github/ — new CI jobs, triggers, matrices, checkout/clone tuning, action…

    721 GitHub stars~11k tokensUpdated today
    DevelopmentAuto-check passed

More from ROCm/FlyDSL

All 19 skills in this repo
  • Llvm

    ROCm/FlyDSL

    Tune and analyse a FlyDSL kernel at the LLVM level: pick a compile hint, function attribute, or AMDGPU backend flag, then PROVE it reached codegen.

    287 GitHub stars~4.9k tokensUpdated today
    Auto-check: notes
  • Detect per-kernel GPU resource regressions (VGPR, SGPR, register spills, scratch, static LDS) by diffing the final ISA before and after a change, using its isaresourcetable.py helper.

    287 GitHub stars~2.7k tokensUpdated today
    Auto-check: notes
  • API Stability

    ROCm/FlyDSL

    Review a FlyDSL PR, commit, branch, kernel, or consuming module for API-stability compliance.

    287 GitHub stars~3.2k tokensUpdated today
    Auto-check: notes
  • Build Rocm Image

    ROCm/FlyDSL

    Connect to a remote host via SSH and build a Docker image with rocprofv3, aiter, and FlyDSL.

    287 GitHub stars~1.2k tokensUpdated today
    Auto-check: notes
  • Guided step-by-step wizard for producing a new FlyDSL GPU kernel from a requirement: classify the kernel type, pick a skeleton, fill in compute, add control flow / sync / LDS, then test on GPU.

    287 GitHub stars~4.6k tokensUpdated today
    Auto-check: notes
  • Format Code

    ROCm/FlyDSL

    Format, clean up, and style-check changed files, matching the project's CI style gate.

    287 GitHub stars~1.9k tokensUpdated today
    Auto-check: notes

Questions about Debug Flydsl Kernel

What does Debug Flydsl Kernel do?

Debug FlyDSL GPU kernels that produce NaN, inf, wrong results, or crash. Debug Flydsl Kernel is an agent skill from ROCm/FlyDSL. Debug FlyDSL GPU kernels that produce NaN, inf, wrong results, or crash.

When should I use Debug Flydsl Kernel?

Debug Flydsl Kernel fits situations like: A FlyDSL kernel produces incorrect output; compilation errors.

How do I install Debug Flydsl Kernel in Claude Code?

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

How do I install Debug Flydsl Kernel in Codex?

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

Can I use Debug Flydsl Kernel 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 ROCm/FlyDSL --skill debug-flydsl-kernel -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-flydsl-kernel, .gemini/skills/debug-flydsl-kernel, .github/skills/debug-flydsl-kernel and .opencode/skills/debug-flydsl-kernel in your project.

What does Debug Flydsl Kernel need to run?

SKILL.md names no scripts, command-line tools or credentials: Debug Flydsl Kernel is instructions for the agent only. Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Edit, Bash, Grep, Glob, Agent.

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

Our automated static check of SKILL.md found notes only (runs commands with sudo; 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 Flydsl Kernel use?

Debug Flydsl Kernel 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 Debug Flydsl Kernel use?

About 2.6k tokens (SKILL.md is roughly 10k 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 Flydsl Kernel?

Skills that share tags, products or a category with Debug Flydsl Kernel: Native Data Fetching (CherryHQ/cherry-studio-app, 4k stars), Keybase RPC Log Analysis (keybase/client, 9.3k stars), ML Failure Debugger (Leeroo-AI/superml, 195 stars) and Flowfile Debugging Playbook (Edwardvaneechoud/Flowfile, 370 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debug Flydsl Kernel?

ROCm (a GitHub organization) maintains it in ROCm/FlyDSL, which has 287 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 7, 2026.

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