Agent skill

Setup Docs

by linuxfoundation in linuxfoundation/insights

Run the docs site, blog, or Storybook locally. An agent skill from linuxfoundation/insights.

MITAuto-check: notesFrontend & Design

Install Setup Docs

skills CLI
$ npx skills add linuxfoundation/insights --skill setup-docs -a claude-code

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

GitHub CLI
$ gh skill install linuxfoundation/insights setup-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/linuxfoundation/insights.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/setup-docs .claude/skills/setup-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
setup-docs
GitHub stars
280
Token cost
~383 tokens
SKILL.md length
127 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Run the docs site, blog, or Storybook locally. An agent skill from linuxfoundation/insights.

  • Contributing to documentation
  • SKILL.md covers Docs site, Blog, Storybook and Troubleshooting
  • Calls pnpm
  • Previewing blog posts

What it does

Setup Docs is an agent skill from linuxfoundation/insights. Run the docs site, blog, or Storybook locally. Use when contributing to documentation, previewing blog posts, or developing UI components in isolation. Not needed for regular frontend development.

Its SKILL.md is about 380 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, Frontend development and Blog and article writing. It works with Storybook. The repository describes itself as: Insights into the world's most critical open source software. The licence is MIT.

When your agent uses it

  • Contributing to documentation
  • Previewing blog posts
  • Developing UI components in isolation

Example prompts

  • “/setup-docs”

Requirements

  • Pre-approved tools (allowed-tools): Bash

What it can do on your machine

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

    • Bash

    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

Setup Docs loads about 383 tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 127 words of instructions outside code blocks.

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

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.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

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 linuxfoundation/insights at commit 3df53b5, republished under its MIT licence (© linuxfoundation). 127 words, ~383 tokens.

Download SKILL.mdSave it as .claude/skills/setup-docs/SKILL.md (or your agent's skills folder).
name
setup-docs
description
Run the docs site, blog, or Storybook locally. Use when contributing to documentation, previewing blog posts, or developing UI components in isolation. Not needed for regular frontend development.
allowed-tools
Bash

Local Docs, Blog & Storybook Setup

These are all independent of the main dev server — you don't need the database or Auth0 configured to run any of them. Just make sure dependencies are installed first (pnpm install --filter frontend from the repo root).

All commands run from the frontend/ directory.


Docs site

VitePress docs served at http://localhost:5173:

bash
cd frontend && pnpm docs:dev

Build and preview the production output:

bash
cd frontend && pnpm docs:build && pnpm docs:preview

Blog

VitePress blog served at http://localhost:5174:

bash
cd frontend && pnpm blog:dev

Build and preview:

bash
cd frontend && pnpm blog:build && pnpm blog:preview --port 5174

Storybook

Component development and documentation, served at http://localhost:6006:

bash
cd frontend && pnpm storybook

Build static Storybook:

bash
cd frontend && pnpm storybook:build

Troubleshooting

  • Port already in use — kill the process using the port or change it with --port <N>
  • Missing dependencies — run pnpm install --filter frontend from the repo root first
  • Storybook build errors — usually a component import issue; check the console output for the failing story

© linuxfoundation, 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/setup-docs of linuxfoundation/insights.

Open the folder on GitHubat commit 3df53b5

Compare with similar skills

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

Setup Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup Docs this skilllinuxfoundation/insights280—~383Automated safety check: NotesMIT
Tabler Astro Dev Servertabler/tabler42k—~1.2kAutomated safety check: PassMIT
Tabler Astro Component Scriptstabler/tabler42k—~2.1kAutomated safety check: PassMIT
Phoenix FrontendArize-ai/phoenix12k—~709Automated safety check: PassCustom licence
Tabler Demo Page Buildertabler/tabler42k—~2.2kAutomated safety check: PassMIT
Bryl Minimal Designbryllim/bryl-minimal-design114—~2.9kAutomated safety check: PassMIT

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 yesterday
    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 yesterday
    Frontend & DesignAuto-check passed
  • Phoenix Frontend

    Arize-ai/phoenix

    Frontend development guidelines for the Phoenix AI observability platform.

    12k GitHub stars~709 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Builds or updates a Tabler component preview page under preview/pages, covering the page skeleton, header, and card grid conventions.

    42k GitHub stars~2.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Bryl Minimal Design

    bryllim/bryl-minimal-design

    Apply the bryl-minimal design language — a monochrome, typography-driven minimal aesthetic with halftone dot textures, pixel-font display headings, tiny uppercase monospace labels, soft large-radius…

    114 GitHub stars~2.9k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

    Create distinctive, production-grade static sites with React, Tailwind CSS, and shadcn/ui — no mockups needed.

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Frontend & DesignAuto-check passed

More from linuxfoundation/insights

All 9 skills in this repo
  • Event Tracking

    linuxfoundation/insights

    Add event tracking calls to Vue/Nuxt components in the Insights app using the useTrackEvent composable.

    280 GitHub stars~1.9k tokensUpdated 7 days ago
    Auto-check passed
  • Review PR

    linuxfoundation/insights

    Review a pull request against Insights architecture standards — fetches PR diff, verifies previous comments are addressed, validates PR metadata (title, branch, JIRA, size), runs a code-standards…

    280 GitHub stars~2.7k tokensUpdated 7 days ago
    Auto-check: notes
  • Adr

    linuxfoundation/insights

    Record an architecture decision as an ADR in api/docs/arch/adr/.

    280 GitHub stars~1k tokensUpdated 7 days ago
    Auto-check passed
  • Dco

    linuxfoundation/insights

    Recover from missing DCO sign-off on commits. An agent skill from linuxfoundation/insights.

    280 GitHub stars~696 tokensUpdated 7 days ago
    Auto-check: notes
  • Fix Vulns

    linuxfoundation/insights

    Automated triage and fixing of Dependabot security vulnerabilities (IN-1189).

    280 GitHub stars~3.8k tokensUpdated 7 days ago
    Auto-check: notes
  • Setup

    linuxfoundation/insights

    Full development environment setup from scratch — prerequisites, dependencies, .env file, optional local PostgreSQL database (for auth/collections/chat work), and dev server.

    280 GitHub stars~1.9k tokensUpdated 7 days ago
    Auto-check: notes

Works with

Questions about Setup Docs

What does Setup Docs do?

Run the docs site, blog, or Storybook locally. An agent skill from linuxfoundation/insights. Setup Docs is an agent skill from linuxfoundation/insights. Run the docs site, blog, or Storybook locally.

When should I use Setup Docs?

Setup Docs fits situations like: contributing to documentation; previewing blog posts; developing UI components in isolation.

How do I install Setup Docs in Claude Code?

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

How do I install Setup Docs in Codex?

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

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

What does Setup Docs need to run?

Going by SKILL.md and its folder, Setup Docs needs the command-line tools its instructions call (pnpm). Its frontmatter pre-approves these tools: Bash.

Does Setup 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 Setup Docs safe to install?

Our automated static check of SKILL.md found notes only (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 Setup Docs use?

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

About 383 tokens (SKILL.md is roughly 1.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 Setup Docs?

Skills that share tags, products or a category with Setup Docs: Tabler Astro Dev Server (tabler/tabler, 42k stars), Tabler Astro Component Scripts (tabler/tabler, 42k stars), Phoenix Frontend (Arize-ai/phoenix, 12k stars) and Tabler Demo Page Builder (tabler/tabler, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup Docs?

linuxfoundation (a GitHub organization) maintains it in linuxfoundation/insights, which has 280 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 1, 2026.

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