Agent skill

AI Docs

by foldkit in foldkit/foldkit

AI documentation. An agent skill from foldkit/foldkit.

MITAuto-check passed

Install AI Docs

skills CLI
$ npx skills add foldkit/foldkit --skill ai-docs -a claude-code

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

GitHub CLI
$ gh skill install foldkit/foldkit ai-docs --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/foldkit/foldkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/repos/effect/.agents/skills/ai-docs .claude/skills/ai-docs && 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
ai-docs
GitHub stars
918
Token cost
~172 tokens
SKILL.md length
80 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

AI documentation. An agent skill from foldkit/foldkit.

  • Works in 4 steps: Inspect neighboring source examples and… → Edit sources under ai-docs/src, then run… → Review generated output for ordering,… → …
  • Editing ai-docs/src
  • Calls pnpm
  • Regenerating LLMS.md

What it does

AI Docs is an agent skill from foldkit/foldkit. AI documentation. Use when editing ai-docs/src or regenerating LLMS.md.

Its SKILL.md is about 170 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The licence is MIT.

When your agent uses it

  • Editing ai-docs/src
  • Regenerating LLMS.md

Example prompts

  • “/ai-docs”

Workflow steps

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

  1. Inspect neighboring source examples and the relevant current LLMS.md.
  2. Edit sources under ai-docs/src, then run pnpm ai-docgen.
  3. Review generated output for ordering, missing content, and unrelated changes.
  4. Run applicable root validation.

What it can do on your machine

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

    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

AI Docs loads about 172 tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 80 words of instructions outside code blocks.

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

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 foldkit/foldkit at commit d21db42, republished under its MIT licence (© foldkit). 80 words, ~172 tokens.

Download SKILL.mdSave it as .claude/skills/ai-docs/SKILL.md (or your agent's skills folder).
name
ai-docs
description
AI documentation. Use when editing ai-docs/src or regenerating LLMS.md.

Read ai-docs/README.md; it owns source structure, style, examples, generation, and changeset policy.

  1. Inspect neighboring source examples and the relevant current LLMS.md.
  2. Edit sources under ai-docs/src, then run pnpm ai-docgen.
  3. Review generated output for ordering, missing content, and unrelated changes.
  4. Run applicable root validation.

The task is complete when sources and generated output agree, every generated difference is explained, TypeScript checks pass when examples or fixtures change, and applicable checks pass or are reported as not runnable.

© foldkit, 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 repos/effect/.agents/skills/ai-docs of foldkit/foldkit.

Open the folder on GitHubat commit d21db42

Compare with similar skills

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

AI Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
AI Docs this skillfoldkit/foldkit918—~172Automated safety check: PassMIT
Orchardcore Nswag RegenerateOrchardCMS/OrchardCore8.2k—~2kAutomated safety check: PassBSD-3-Clause
Regenerate Grpc StubsGetBindu/Bindu10k—~810Automated safety check: PassCustom licence
Regenerating ScreenshotsComfy-Org/ComfyUI_frontend2.1k—~643Automated safety check: PassGPL-3.0
Regenerate PgoDeedleFake/trayscale1.1k—~984Automated safety check: PassMIT
Icons Srcforcedotcom/salesforcedx-vscode1k—~891Automated safety check: PassBSD-3-Clause

Similar skills

  • Orchardcore Nswag Regenerate

    OrchardCMS/OrchardCore

    Regenerate the OrchardCore.OpenApi module's NSwag-generated C/TypeScript API clients, and verify the regeneration produces a stable (non-reshuffled) diff.

    8.2k GitHub stars~2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Regenerate Grpc Stubs

    GetBindu/Bindu

    Regenerate Python + TypeScript gRPC stubs after editing proto files.

    10k GitHub stars~810 tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Regenerating Screenshots

    Comfy-Org/ComfyUI_frontend

    Creates a PR to regenerate Playwright screenshot expectations.

    2.1k GitHub stars~643 tokensUpdated today
    Testing & QAAuto-check passed
  • Regenerate Pgo

    DeedleFake/trayscale

    Regenerate cmd/trayscale/default.pgo by launching an isolated Trayscale, driving representative UI paths under PPROF, then replacing the profile.

    1.1k GitHub stars~984 tokensUpdated today
    Auto-check passed
  • Icons Src

    forcedotcom/salesforcedx-vscode

    Add custom SVG icons to salesforcedx-vscode-services for font generation.

    1k GitHub stars~891 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Regenerate cached LLM responses for tests that replay model fixtures.

    525 GitHub stars~1.1k tokensUpdated today
    Testing & QAAuto-check passed

More from foldkit/foldkit

All 18 skills in this repo
  • Commit Changes

    foldkit/foldkit

    Create a git commit in the Foldkit monorepo with changeset enforcement and formatting.

    918 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Foldkit

    foldkit/foldkit

    A skill your agent uses whenever working with Foldkit. An agent skill from foldkit/foldkit.

    918 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Outline, draft, or revise a Foldkit version release blog post using the repository's announcement style and editorial preferences.

    918 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Audit Program

    foldkit/foldkit

    Audit an existing Foldkit program against the architecture, conventions, and quality bar.

    918 GitHub stars~7.2k tokensUpdated today
    Auto-check passed
  • Generate Program

    foldkit/foldkit

    Generate a complete, idiomatic Foldkit program from a natural language description.

    918 GitHub stars~20k tokensUpdated today
    Auto-check passed
  • Changesets

    foldkit/foldkit

    Concise PR finalization changesets. An agent skill from foldkit/foldkit.

    918 GitHub stars~923 tokensUpdated today
    Auto-check passed

Questions about AI Docs

What does AI Docs do?

AI documentation. An agent skill from foldkit/foldkit. AI Docs is an agent skill from foldkit/foldkit. AI documentation.

When should I use AI Docs?

AI Docs fits situations like: editing ai-docs/src; regenerating LLMS.md.

How do I install AI Docs in Claude Code?

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

How do I install AI Docs in Codex?

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

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

What does AI Docs need to run?

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

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

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

About 172 tokens (SKILL.md is roughly 688 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 AI Docs?

Skills that share tags, products or a category with AI Docs: Orchardcore Nswag Regenerate (OrchardCMS/OrchardCore, 8.2k stars), Regenerate Grpc Stubs (GetBindu/Bindu, 10k stars), Regenerating Screenshots (Comfy-Org/ComfyUI_frontend, 2.1k stars) and Regenerate Pgo (DeedleFake/trayscale, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains AI Docs?

foldkit (a GitHub organization) maintains it in foldkit/foldkit, which has 918 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 8, 2026.

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