Agent skill

Docs Skill

by TypeCellOS in TypeCellOS/BlockNote

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

Custom licenceAuto-check passedFrontend & Design

Install Docs Skill

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

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

GitHub CLI
$ gh skill install TypeCellOS/BlockNote docs-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/docs-skill .claude/skills/docs-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
docs-skill
GitHub stars
10k
Token cost
~1.9k tokens
SKILL.md length
1,069 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Tasks that involve Static sites and blogs
  • SKILL.md covers Structure principles, Prose style, Verifying content and Site mechanics
  • Calls pnpm and node

What it does

Docs Skill is an agent skill from TypeCellOS/BlockNote. Conventions and verification workflow for writing and restructuring the documentation site (docs/content). Should be used when adding, editing, or reviewing docs pages.

Its SKILL.md is about 1.9k 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 Frontend & Design, covering Static sites and blogs. 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 Static sites and blogs

Example prompts

  • “Use the docs-skill skill to convention and verification workflow for writing and restructuring the documentation site (docs/content)”
  • “/docs-skill”

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

    Shell commands in SKILL.md call:

    • pnpm
    • node

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

  • Network

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

Docs Skill loads about 1.9k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 1,069 words of instructions outside code blocks.

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

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,069 words (~1,878 tokens).

“The documentation site lives in docs/content/docs (fumadocs + Next.js). These are the conventions for writing and verifying it.”

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

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit 4120e9d

Compare with similar skills

Docs 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.

Docs Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Skill this skillTypeCellOS/BlockNote10k—~1.9kAutomated safety check: PassCustom licence
Tabler Astro Dev Servertabler/tabler42k—~1.2kAutomated safety check: PassMIT
Create Docsvictorgarciaesgi/nuxt-typed-router4132 repos~2.8kAutomated safety check: PassMIT
Tabler Astro Component Scriptstabler/tabler42k—~2.1kAutomated safety check: PassMIT
Paperclip Pagepaperclipai/paperclip98k—~1kAutomated safety check: PassMIT
Kill AI Slopyetone/kill-ai-slop1.3k—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Starts the right Tabler dev server, keeps it from clashing with builds and verifies changes in the browser before a page or component is handed back.

    42k GitHub stars~1.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Create Docs

    victorgarciaesgi/nuxt-typed-router

    Create complete documentation sites for projects. An agent skill from victorgarciaesgi/nuxt-typed-router.

    413 GitHub starsUsed in 2 repos~2.8k tokens
    Frontend & DesignAuto-check passed
  • Rules for adding or fixing client-side scripts in Tabler's Astro components so the copied preview HTML stays readable, self-contained and runs in the right order.

    42k GitHub stars~2.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Paperclip Page

    paperclipai/paperclip

    Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.

    98k GitHub stars~1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Kill AI Slop

    yetone/kill-ai-slop

    Find and remove AI slop — the generic, machine-default visual and copy tics of vibe-coded products — from a web project.

    1.3k GitHub stars~1.4k tokensUpdated 22 days ago
    Frontend & DesignAuto-check passed
  • Official

    Audit a documentation site for agent-friendliness: discovery, markdown delivery, crawlability, semantic structure, machine-readable surfaces, and content legibility.

    4.7k GitHub stars~1.8k tokensUpdated today
    Frontend & DesignAuto-check passed

More from TypeCellOS/BlockNote

  • Debug Skill

    TypeCellOS/BlockNote

    Instructions for navigating and debugging BlockNote in a browser.

    10k GitHub stars~1.8k 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

Questions about Docs Skill

What does Docs Skill do?

Conventions and verification workflow for writing and restructuring the documentation site (docs/content). Docs Skill is an agent skill from TypeCellOS/BlockNote. Conventions and verification workflow for writing and restructuring the documentation site (docs/content).

When should I use Docs Skill?

Docs Skill fits situations like: tasks that involve Static sites and blogs.

How do I install Docs Skill in Claude Code?

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

How do I install Docs Skill in Codex?

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

Can I use Docs 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 docs-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/docs-skill, .gemini/skills/docs-skill, .github/skills/docs-skill and .opencode/skills/docs-skill in your project.

What does Docs Skill need to run?

Going by SKILL.md and its folder, Docs Skill needs the command-line tools its instructions call (pnpm and node).

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

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

About 1.9k tokens (SKILL.md is roughly 7.5k 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 Docs Skill?

Skills that share tags, products or a category with Docs Skill: Tabler Astro Dev Server (tabler/tabler, 42k stars), Create Docs (victorgarciaesgi/nuxt-typed-router, 413 stars), Tabler Astro Component Scripts (tabler/tabler, 42k stars) and Paperclip Page (paperclipai/paperclip, 98k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Skill?

TypeCellOS (a GitHub organization) maintains it in TypeCellOS/BlockNote, which has 10,269 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 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.