New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Kb Setup

by BlackBeltTechnology in BlackBeltTechnology/pi-agent-dashboard

Set up, initialize, or configure the local markdown knowledge base for a project.

MITAuto-check passedKnowledge Management

Install Kb Setup

skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill kb-setup -a claude-code

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

GitHub CLI
$ gh skill install BlackBeltTechnology/pi-agent-dashboard kb-setup --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/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/kb/skill/kb-setup .claude/skills/kb-setup && 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
kb-setup
GitHub stars
315
Token cost
~776 tokens
SKILL.md length
369 words
Files
1
Skills in repo
66
Repo updated
First seen
Licence
MIT

At a glance

Set up, initialize, or configure the local markdown knowledge base for a project.

  • Works in 6 steps: Detect existing config. Check… → Choose scope + sources. Ask (if unclear)… → Scaffold. kb init [--global] [--source… → …
  • The user says set up the knowledge base
  • SKILL.md covers When to Use, Procedure, Pitfalls and Verification
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Kb Setup is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Set up, initialize, or configure the local markdown knowledge base for a project. Use when the user says "set up the knowledge base", "init the KB", "configure the markdown KB", "index my docs", "add a doc source to the KB", or wants the project's markdown searchable by kb search. Wraps kb init end-to-end through kb index and a smoke kb search.

Its SKILL.md is about 780 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 Knowledge Management, covering Knowledge bases and Markdown. The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.

When your agent uses it

  • The user says set up the knowledge base
  • Configure the markdown KB
  • Add a doc source to the KB
  • Wants the projects markdown searchable by kb search

Example prompts

  • “set up the knowledge base”
  • “init the KB”
  • “configure the markdown KB”
  • “/kb-setup”

Workflow steps

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

  1. Detect existing config. Check .pi/dashboard/knowledge_base.json
  2. Choose scope + sources. Ask (if unclear) whether to write project or
  3. Scaffold. kb init [--global] [--source ]... [--dry-run].
  4. Index. kb index → reports files scanned / changed / chunks. First run
  5. Smoke search. kb search "" --limit 5 and
  6. Point the user at the kb-search SKILL for everyday retrieval.

What it can do on your machine

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

Kb Setup loads about 776 tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 369 words of instructions outside code blocks.

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

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 BlackBeltTechnology/pi-agent-dashboard at commit e23e533, republished under its MIT licence (© BlackBeltTechnology). 369 words, ~776 tokens.

Download SKILL.mdSave it as .claude/skills/kb-setup/SKILL.md (or your agent's skills folder).
name
kb-setup
description
Set up, initialize, or configure the local markdown knowledge base for a project. Use when the user says "set up the knowledge base", "init the KB", "configure the markdown KB", "index my docs", "add a doc source to the KB", or wants the project's markdown searchable by `kb search`. Wraps `kb init` end-to-end through `kb index` and a smoke `kb search`.

kb-setup — bring up the project knowledge base

@blackbelt-technology/pi-dashboard-kb builds a zero-token, local SQLite/FTS5 index over this project's markdown so kb-search can retrieve before answering. This SKILL does the one-time bring-up. Retrieval is pull (the agent calls kb); nothing is auto-injected.

When to Use

  • User asks to set up / init / configure the knowledge base.
  • No .pi/dashboard/knowledge_base.json exists yet and the project has docs.
  • User wants to add a doc source (local dir, npm package docs, git handbook).

Procedure

  1. Detect existing config. Check .pi/dashboard/knowledge_base.json (project) and ~/.pi/dashboard/knowledge_base.json (global). Run kb config to see the resolved layering. If a project config already exists and is healthy, skip to step 5 (smoke search) unless the user wants changes.
  2. Choose scope + sources. Ask (if unclear) whether to write project or global config. Pick sources[]:
    • local doc dir: { "kind": "filesystem", "ref": "docs", "priority": 10 } (higher priority = preferred when the same content appears in two roots)
    • AGENTS.md / CLAUDE.md: covered by indexAgentsFiles: true (default on)
    • source-tree *.md: covered by includeSourceMarkdown: true (default on)
    • remote sources (npm/git/https) require trust-on-first-use — defer unless the user explicitly asks; remote resolvers land in a later phase.
  3. Scaffold. kb init [--global] [--source <ref>]... [--dry-run]. Review the --dry-run output with the user, then run for real. kb init refuses to clobber an existing config without --force, and gitignores the dbPath.
  4. Index. kb index → reports files scanned / changed / chunks. First run is the cold index; later runs are incremental (mtime → sha256).
  5. Smoke search. kb search "<a real term from the docs>" --limit 5 and confirm ranked {path, headingPath, score, snippet} come back. If empty, check kb config shows the right sources and that the dir has .md files.
  6. Point the user at the kb-search SKILL for everyday retrieval.
Show full SKILL.md (81 more words)Show less

Pitfalls

  • Do NOT overwrite an existing config without confirming — use --force only after the user agrees.
  • dbPath must be gitignored; kb init does this for project configs. For a custom dbPath outside the project, add the gitignore entry yourself.
  • No sources[] → kb index exits 2. Always seed at least one filesystem source.

Verification

  • kb config prints origin, dbAbsPath, and the resolved sources list.
  • kb index reports N files … M chunks and store.counts() JSON.
  • kb search "<term>" returns ranked hits with snippets.

© BlackBeltTechnology, 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 packages/kb/skill/kb-setup of BlackBeltTechnology/pi-agent-dashboard.

Open the folder on GitHubat commit e23e533

Compare with similar skills

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

Kb Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kb Setup this skillBlackBeltTechnology/pi-agent-dashboard315—~776Automated safety check: PassMIT
QmdSAP/e-mobility-charging-stations-simulator2271 repos~2.8kAutomated safety check: PassMIT
Wiki Viewerrohitg00/pro-workflow2.9k—~1.1kAutomated safety check: PassNone
Okf Open Knowledge Formatfabricioctelles/skills106—~5.7kAutomated safety check: PassApache-2.0
Qmdcompozy/compozy2.8k—~1kAutomated safety check: PassMIT
Ingest SourceAbilityai/cornelius109—~4.3kAutomated safety check: NotesMIT

Similar skills

  • Qmd

    SAP/e-mobility-charging-stations-simulator

    Official

    Search local markdown knowledge bases, notes, docs, and wikis with QMD.

    227 GitHub starsUsed in 1 repo~2.8k tokens
    Knowledge ManagementAuto-check passed

  • Wiki Viewer

    rohitg00/pro-workflow

    Render a self-contained HTML viewer for a pro-workflow wiki.

    2.9k GitHub stars~1.1k tokensUpdated 9 days ago
    Knowledge ManagementAuto-check passed

  • Okf Open Knowledge Format

    fabricioctelles/skills

    Create, validate, and enrich Open Knowledge Format (OKF) bundles — the open spec for representing organizational knowledge as markdown files with YAML frontmatter.

    106 GitHub stars~5.7k tokensUpdated 3 days ago
    Knowledge ManagementAuto-check passed

  • Qmd

    compozy/compozy

    Search markdown knowledge bases, notes, and documentation using QMD.

    2.8k GitHub stars~1k tokensUpdated today
    Knowledge ManagementAuto-check passed

  • Ingest Source

    Abilityai/cornelius

    Fully autonomous end-to-end ingestion of a SINGLE source (book, paper, article, transcript) into the knowledge base - prepare to markdown, extract insights against the live index, refresh the index…

    109 GitHub stars~4.3k tokensUpdated 15 days ago
    Knowledge ManagementAuto-check: notes

  • Outline

    Vortiago/mcp-outline

    Conventions and efficient workflows for Outline knowledge bases via mcp-outline tools.

    156 GitHub stars~818 tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed

More from BlackBeltTechnology/pi-agent-dashboard

All 66 skills in this repo

  • Browser

    BlackBeltTechnology/pi-agent-dashboard

    Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed

  • Pi Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

  • CI Troubleshoot

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…

    315 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

  • Debug Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.

    315 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Implement

    BlackBeltTechnology/pi-agent-dashboard

    Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.

    315 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Session To Guideline

    BlackBeltTechnology/pi-agent-dashboard

    Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…

    315 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Kb Setup

What does Kb Setup do?

Set up, initialize, or configure the local markdown knowledge base for a project. Kb Setup is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Set up, initialize, or configure the local markdown knowledge base for a project.

When should I use Kb Setup?

Kb Setup fits situations like: the user says set up the knowledge base; configure the markdown KB; add a doc source to the KB; wants the projects markdown searchable by kb search.

How do I install Kb Setup in Claude Code?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill kb-setup -a claude-code`. Or copy the skill folder (packages/kb/skill/kb-setup in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/kb-setup in your project. Claude Code loads it when a task matches its description.

How do I install Kb Setup in Codex?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill kb-setup -a codex`. Or copy the skill folder (packages/kb/skill/kb-setup in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/kb-setup in your project. Codex loads it when a task matches its description.

Can I use Kb Setup 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 BlackBeltTechnology/pi-agent-dashboard --skill kb-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kb-setup, .gemini/skills/kb-setup, .github/skills/kb-setup and .opencode/skills/kb-setup in your project.

What does Kb Setup need to run?

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

Does Kb Setup 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 Kb Setup 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 Kb Setup use?

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

About 776 tokens (SKILL.md is roughly 3.1k 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 Kb Setup?

Skills that share tags, products or a category with Kb Setup: Qmd (SAP/e-mobility-charging-stations-simulator, 227 stars), Wiki Viewer (rohitg00/pro-workflow, 2.9k stars), Okf Open Knowledge Format (fabricioctelles/skills, 106 stars) and Qmd (compozy/compozy, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kb Setup?

BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on October 8, 2026.

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