Agent skill

Documentation

by wellwelwel in wellwelwel/poku

Documentation deep-dive for the poku website covering Docusaurus setup, language policy, feature-to-docs mapping, conventions, JSDoc, and the changelog.

MITAuto-check passedDevelopment

Install Documentation

skills CLI
$ npx skills add wellwelwel/poku --skill documentation -a claude-code

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

GitHub CLI
$ gh skill install wellwelwel/poku documentation --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/wellwelwel/poku.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/documentation .claude/skills/documentation && 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
documentation
GitHub stars
1.2k
Token cost
~982 tokens
SKILL.md length
476 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Documentation deep-dive for the poku website covering Docusaurus setup, language policy, feature-to-docs mapping, conventions, JSDoc, and the changelog.

  • Works in 8 steps: Framework & Config → Language Policy → Documentation Structure → …
  • Mapping a feature to its page
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Technical documentation

What it does

Documentation is an agent skill from wellwelwel/poku. Documentation deep-dive for the poku website covering Docusaurus setup, language policy, feature-to-docs mapping, conventions, JSDoc, and the changelog. Use when editing or adding docs or mapping a feature to its page.

Its SKILL.md is about 980 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 Technical documentation and Changelog and release notes. The repository describes itself as: 🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time. The licence is MIT.

When your agent uses it

  • Mapping a feature to its page
  • Tasks that involve Technical documentation
  • Tasks that involve Changelog and release notes

Example prompts

  • “/documentation”

Workflow steps

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

  1. Framework & Config
  2. Language Policy
  3. Documentation Structure
  4. Feature-to-Docs Mapping
  5. Documentation Conventions
  6. Inline Documentation (JSDoc)
  7. LLM Docs (Context7)
  8. Changelog

What it can do on your machine

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

Documentation loads about 982 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 476 words of instructions outside code blocks.

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

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

The full file from wellwelwel/poku at commit e02df0b, republished under its MIT licence (© wellwelwel). 476 words, ~982 tokens.

Download SKILL.mdSave it as .claude/skills/documentation/SKILL.md (or your agent's skills folder).
name
documentation
description
Documentation deep-dive for the poku website covering Docusaurus setup, language policy, feature-to-docs mapping, conventions, JSDoc, and the changelog. Use when editing or adding docs or mapping a feature to its page.

Documentation conventions and where to look. Read the actual website/ tree and config to confirm details, since pages and versions change over time.

1. Framework & Config
  • Docusaurus 3.x at website/. For the exact version, read website/package.json
  • Config: website/docusaurus.config.ts. Sidebar: website/sidebars.ts (top-level items are manual, the docs/tutorials/examples categories are autogenerated from their directories)
  • Versioning: the current docs are the active version, older majors are kept but marked unmaintained. Read the versions block in website/docusaurus.config.ts and website/versions.json for the live set of versions and their labels
2. Language Policy
  • English is mandatory. Use i18n (website/i18n/) only on explicit user request
3. Documentation Structure

The docs live under website/docs/:

  • Root pages cover the homepage, philosophy, and the comparison with other runners
  • documentation/ is the API reference, organized by area: assertions, helper APIs (under helpers/), and the poku runner with its CLI options (under poku/)
  • tutorials/ holds guided walkthroughs and examples/ holds runnable examples

Read the website/docs/ tree to discover the current pages rather than relying on a fixed list here, since pages are added and reorganized.

4. Feature-to-Docs Mapping

There is a close (not strictly 1:1) mapping between helper APIs in src/modules/helpers/ and pages under website/docs/documentation/helpers/. Conventions to expect:

  • Most helpers have a matching page of the same name
  • Related helpers are sometimes grouped into a subdirectory (for example, process-related helpers)
  • A single source helper can be split across multiple pages, and a single page can cover more than one export
  • The config option types inform the poku/options/ pages
  • The public surface is whatever package.json exports define, not the internal file layout

To find the doc for a feature, read the helpers directory and the docs directory and match by responsibility, rather than trusting a fixed table.

Show full SKILL.md (192 more words)Show less
5. Documentation Conventions

When reading or writing docs, follow these patterns:

  • Front matter: YAML with sidebar_position and tags
  • Page structure: function signature (> fn(params)) then Basic Usage then Advanced then FAQ
  • Components: reusable MDX components live in website/src/components/ (for example FAQ, and History to document when a feature became available or had breaking changes across versions). Docusaurus components like Tabs/TabItem are also available
  • Category organization: _category_.json files
  • Punctuation: Use proper punctuation. Never use any kind of substitute as a crutch
  • Consistency: Match the writing style, tone, and structure of the related existing docs
6. Inline Documentation (JSDoc)
  • Type definitions live in src/@types/
  • Pattern: description plus an @default tag
  • These inform the documentation content
7. LLM Docs (Context7)
  • website/llms/ holds docs written for LLMs and indexed by Context7, separate from the human-facing pages in website/docs/
  • Current files: llms.md (the llms.txt entry point, symlinked to website/static/llms.txt), comparing.md, and philosophy.md
  • context7.json at the repo root controls what Context7 indexes and how it guides the agent through the folders allowlist (which includes website/llms), the description, and the rules
  • The description and rules have Context7 length limits, validated by test/unit/context7-rules.test.ts
8. Changelog
  • CHANGELOG.md is auto-generated: NEVER edit it!

© wellwelwel, MIT. 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/documentation of wellwelwel/poku.

Open the folder on GitHubat commit e02df0b

Compare with similar skills

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

Documentation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Documentation this skillwellwelwel/poku1.2k—~982Automated safety check: PassMIT
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
Ccb GitHubSeemSeam/claude_codex_bridge3.6k—~4.9kAutomated safety check: PassCustom licence
Golang Documentationunxed/f42413 repos~3.5kAutomated safety check: PassMIT
Simple Englishropensci/ckanr1043 repos~2kAutomated safety check: PassMIT
Opik Documentation Patternscomet-ml/opik22k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • Ccb GitHub

    SeemSeam/claude_codex_bridge

    Maintain this CCB project's GitHub-facing release and npm publication surface.

    3.6k GitHub stars~4.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Comprehensive documentation guide for Golang projects, covering godoc comments, README, CONTRIBUTING, CHANGELOG, Go Playground, Example tests, API docs, and llms.txt.

    241 GitHub starsUsed in 3 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Simple English

    ropensci/ckanr

    Write or rewrite text in plain, layman-readable English in the spirit of ASD-STE100 Simplified Technical English: short sentences, active voice, simple tenses, one word one meaning, condition before…

    104 GitHub starsUsed in 3 repos~2k tokens
    DevelopmentAuto-check passed
  • Rules for writing PR descriptions, changelog entries and feature documentation in the Opik repository, including the exact headings that CI requires.

    22k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Release

    jrswab/axe

    Prepare code for release (version bumps, changelog, README updates) and create an annotated tag to trigger the GoReleaser workflow.

    895 GitHub stars~1.4k tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from wellwelwel/poku

  • Benchmarking

    wellwelwel/poku

    Empirical performance comparison playbook for poku covering hypothesis lenses, a standalone harness with a byte-identical correctness gate, variant generation, sequential hyperfine measurement…

    1.2k GitHub stars~3k tokensUpdated 3 mo ago
    Auto-check passed
  • Architecture

    wellwelwel/poku

    Architecture deep-dive for poku covering project structure, execution flow, config discovery, runtime detection, and competitive context.

    1.2k GitHub stars~867 tokensUpdated 3 mo ago
    Auto-check passed
  • Engineering

    wellwelwel/poku

    Engineering deep-dive for poku covering performance, code, and security patterns, TypeScript config, build pipeline, developer experience, and CI/CD.

    1.2k GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Pre Commit

    wellwelwel/poku

    Run the mandatory pre-commit checks for the poku repository before staging a commit.

    1.2k GitHub stars~728 tokensUpdated 3 mo ago
    Auto-check passed
  • Testing

    wellwelwel/poku

    Testing deep-dive for poku covering test structure, commands, patterns, fixtures, utils, Docker compatibility, and coverage.

    1.2k GitHub stars~1k tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Documentation

What does Documentation do?

Documentation deep-dive for the poku website covering Docusaurus setup, language policy, feature-to-docs mapping, conventions, JSDoc, and the changelog. Documentation is an agent skill from wellwelwel/poku. Documentation deep-dive for the poku website covering Docusaurus setup, language policy, feature-to-docs mapping, conventions, JSDoc, and the changelog.

When should I use Documentation?

Documentation fits situations like: mapping a feature to its page; tasks that involve Technical documentation; tasks that involve Changelog and release notes.

How do I install Documentation in Claude Code?

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

How do I install Documentation in Codex?

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

Can I use Documentation 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 wellwelwel/poku --skill documentation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/documentation, .gemini/skills/documentation, .github/skills/documentation and .opencode/skills/documentation in your project.

What does Documentation need to run?

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

Does Documentation 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 Documentation 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 Documentation use?

Documentation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Documentation use?

About 982 tokens (SKILL.md is roughly 3.9k 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 Documentation?

Skills that share tags, products or a category with Documentation: Simple English (moeru-ai/airi, 50k stars), Ccb GitHub (SeemSeam/claude_codex_bridge, 3.6k stars), Golang Documentation (unxed/f4, 241 stars) and Simple English (ropensci/ckanr, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Documentation?

wellwelwel (a GitHub user) maintains it in wellwelwel/poku, which has 1,183 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on June 18, 2026.

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