Agent skill

Debug Skill

by TypeCellOS in TypeCellOS/BlockNote

Instructions for navigating and debugging BlockNote in a browser.

Custom licenceAuto-check passedDevelopment

Install Debug Skill

skills CLI
$ npx skills add TypeCellOS/BlockNote --skill debug-skill -a claude-code

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

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

At a glance

Instructions for navigating and debugging BlockNote in a browser.

  • Works in 4 steps: Apply a code change that you think will… → Test the change in a browser environment. → Take screenshots to verify that the… → …
  • Tasks that involve Debugging
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Debug Skill is an agent skill from TypeCellOS/BlockNote. Instructions for navigating and debugging BlockNote in a browser. Shows how to open specific menus & toolbars, as well select content. Should be used when prompted to fix a bug that requires inspecting the editor's appearance or rendered HTML.

Its SKILL.md is about 1.8k 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 Development, covering Debugging. It works with Notion. The repository describes itself as: A React Rich Text Editor that's block-based (Notion style) and extensible. Built on top of Prosemirror and Tiptap.

When your agent uses it

  • Tasks that involve Debugging

Example prompts

  • “Use the debug-skill skill to instruction for navigating and debugging BlockNote in a browser”
  • “/debug-skill”

Workflow steps

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

  1. Apply a code change that you think will fix the issue.
  2. Test the change in a browser environment.
  3. Take screenshots to verify that the issue is fixed.
  4. Repeat until the bug is indeed fixed.

What it can do on your machine

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

Debug Skill loads about 1.8k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 1,096 words of instructions outside code blocks.

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

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

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

“When fixing a bug, the following feedback loop should be used.”

— opening of SKILL.md by TypeCellOS, Custom licence
name
debug-skill

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/debug-skill of TypeCellOS/BlockNote.

Open the folder on GitHubat commit 4120e9d

Compare with similar skills

Debug Skill 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 Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug Skill this skillTypeCellOS/BlockNote10k—~1.8kAutomated safety check: PassCustom licence
Trellis Session Insightmindfold-ai/Trellis15k4 repos~1.7kAutomated safety check: PassAGPL-3.0
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Native Data FetchingCherryHQ/cherry-studio-app4k6 repos~2.9kAutomated safety check: NotesMIT
Debugging Executionsn8n-io/n8n207k—~2.6kAutomated safety check: PassCustom licence
Aoti Debugpytorch/pytorch104k1 repos~1.7kAutomated safety check: PassCustom licence

Similar skills

  • Trellis Session Insight

    mindfold-ai/Trellis

    Reach into past AI conversation history through the trellis mem CLI.

    15k GitHub starsUsed in 4 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • 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
  • Official

    Debug failed or wrong-output workflow executions using executions tools.

    207k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Aoti Debug

    pytorch/pytorch

    Debug AOTInductor (AOTI) errors and crashes. An agent skill from pytorch/pytorch.

    104k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Runs a disposable, uniquely named Herdr session inside an existing one so runtime, pane, terminal or API bugs can be reproduced without touching the main session.

    43k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed

More from TypeCellOS/BlockNote

  • Docs Skill

    TypeCellOS/BlockNote

    Conventions and verification workflow for writing and restructuring the documentation site (docs/content).

    10k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Testing Skill

    TypeCellOS/BlockNote

    Instructions for writing, running, and updating unit/end-to-end tests.

    10k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Create Example

    TypeCellOS/BlockNote

    Creates a new example under the /examples directory. An agent skill from TypeCellOS/BlockNote.

    10k GitHub stars~943 tokensUpdated today
    Auto-check passed
  • GitHub Issues

    TypeCellOS/BlockNote

    Scan the BlockNote GitHub repository for issues and PRs relevant to the current task.

    10k GitHub stars~283 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Debug Skill

What does Debug Skill do?

Instructions for navigating and debugging BlockNote in a browser. Debug Skill is an agent skill from TypeCellOS/BlockNote. Instructions for navigating and debugging BlockNote in a browser.

When should I use Debug Skill?

Debug Skill fits situations like: tasks that involve Debugging.

How do I install Debug Skill in Claude Code?

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

How do I install Debug Skill in Codex?

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

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

What does Debug Skill need to run?

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

Does Debug Skill 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 Skill 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 Skill use?

Debug Skill 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 Skill use?

About 1.8k tokens (SKILL.md is roughly 7.3k 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 Skill?

Skills that share tags, products or a category with Debug Skill: Trellis Session Insight (mindfold-ai/Trellis, 15k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars), Native Data Fetching (CherryHQ/cherry-studio-app, 4k stars) and Debugging Executions (n8n-io/n8n, 207k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debug Skill?

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

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