Agent skill

Kb Refresh

by techwolf-ai in techwolf-ai/ai-first-toolkit

Add new sources to your knowledge base or re-scrape existing ones to pick up changes.

MITAuto-check passedKnowledge Management

Install Kb Refresh

skills CLI
$ npx skills add techwolf-ai/ai-first-toolkit --skill kb-refresh -a claude-code

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

GitHub CLI
$ gh skill install techwolf-ai/ai-first-toolkit kb-refresh --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/techwolf-ai/ai-first-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/knowledge-base/skills/kb-refresh .claude/skills/kb-refresh && 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-refresh
GitHub stars
132
Token cost
~1.3k tokens
SKILL.md length
362 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
MIT

At a glance

Add new sources to your knowledge base or re-scrape existing ones to pick up changes.

  • Works in 5 steps: Understand Current KB → Discover Sources → Choose Processing Mode → …
  • Tasks that involve Web scraping
  • SKILL.md covers When to Use, Prerequisites, Step 1: Understand Current KB and Step 2: Discover Sources, plus 3 more sections
  • Calls python3

What it does

Kb Refresh is an agent skill from techwolf-ai/ai-first-toolkit. Add new sources to your knowledge base or re-scrape existing ones to pick up changes. Supports Notion, Slack, Confluence, and local files. Can be run anytime after /setup-knowledge-base.

Its SKILL.md is about 1.3k 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 Web scraping and Knowledge bases. It works with Notion, Slack, Confluence and Python. The repository describes itself as: Open-source Claude Code skills and Codex skills for AI-first work. Audit, re-engineer, and bootstrap projects with AI-first design principles. The licence is MIT.

When your agent uses it

  • Tasks that involve Web scraping
  • Tasks that involve Knowledge bases

Example prompts

  • “/kb-refresh”

Requirements

  • Python 3

Workflow steps

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

  1. Understand Current KB
  2. Discover Sources
  3. Choose Processing Mode
  4. Scrape and Extract
  5. Review

What it can do on your machine

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

    • python3

    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 Refresh loads about 1.3k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 362 words of instructions outside code blocks.

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

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 techwolf-ai/ai-first-toolkit at commit 2ee7841, republished under its MIT licence (© techwolf-ai). 362 words, ~1,275 tokens.

Download SKILL.mdSave it as .claude/skills/kb-refresh/SKILL.md (or your agent's skills folder).
name
kb-refresh
description
Add new sources to your knowledge base or re-scrape existing ones to pick up changes. Supports Notion, Slack, Confluence, and local files. Can be run anytime after /setup-knowledge-base.

KB Refresh

Add content from new sources or update existing KB entries from their original sources.

When to Use

  • Adding a new knowledge source (Notion page, Slack channel, etc.) after initial setup
  • Re-scraping sources to pick up recent changes
  • Importing additional documents into the KB

Prerequisites

Check that kb/ and kb/.kb-config.yaml exist. If not, tell the user to run /setup-knowledge-base first.

Step 1: Understand Current KB

Read the KB config and index to understand what's already there:

kb/.kb-config.yaml
kb/index.md

Run the index script to see the current state:

bash
python3 scripts/kb-index.py

Step 2: Discover Sources

Ask the user (use AskUserQuestion with multiSelect):

"What sources do you want to add or refresh?"

  • Notion pages
  • Slack channels
  • Confluence pages
  • Local files or folders
  • Other
Collect Entry Points

For each selected source, ask the user for the entry point:

SourceWhat to askMCP tool
NotionPage URL (will scrape the page and all subpages recursively)notion-fetch with the page URL, then notion-search or notion-get-page-descendants for child pages
SlackChannel name(s) to extract knowledge fromslack_read_channel to read recent messages
ConfluenceSpace key or page URLgetConfluencePage + getConfluencePageDescendants for recursive scraping
Local filesDirectory path or file pathsRead tool directly

Step 3: Choose Processing Mode

Ask the user (use AskUserQuestion):

"Process one at a time or all in parallel?"

  • One at a time (review each before continuing)
  • All in parallel (faster, review at the end)
Show full SKILL.md (134 more words)Show less

Step 4: Scrape and Extract

For each source, launch a subagent (or process sequentially, per the user's choice):

You are populating a knowledge base from an external source.

SOURCE: {source_type}: {url_or_path}

KB CATEGORIES (place entries in the most relevant one):
{list of categories from .kb-config.yaml}

EXISTING ENTRIES (avoid duplicating these):
{output from kb-index.py}

INSTRUCTIONS:
1. Read/scrape the source content using the appropriate tool
2. For Notion/Confluence: follow all child pages and subpages recursively
3. For Slack: focus on pinned messages, bookmarks, and high-signal threads (not casual chat)
4. Split the content into distinct topics. Create one .md file per topic, not one giant file.
5. If an existing entry covers the same topic, UPDATE it rather than creating a duplicate.
   Read the existing file first, merge the new information, and update last_updated.
5a. For org-context KBs (company/team/personal knowledge, not just policy docs), actively hunt for these content types — they are the most commonly missed:
    - **Stakeholders**: one entry per key person (role, ownership areas, how to reach them, what they care about). Without these, the KB can't answer "who should I talk to about X?".
    - **Projects**: one entry per initiative (goal, owner, status, links). Distinct from generic "strategy" entries.
    - **Repositories / codebases**: one entry per repo (purpose, key files, how to run, ownership).
    - **Customer examples**: keep concrete names (e.g., "Acme Corp", "Globex") that make abstract concepts tangible. Don't strip them for anonymity unless the user asks.
6. For new entries, create a file in kb/{category}/ with this format:

---
title: "Topic Title"
description: "Brief one-liner for index lookup"
category: {category}
tags: [{relevant}, {tags}]
sources: ["{source_url_or_path}"]
last_updated: "{today's date}"
---


## Content

Write clear, quotable statements. Each fact should be independently citable.

7. Use lowercase-with-hyphens for filenames: product-overview.md, data-encryption.md
8. Preserve specifics: exact numbers, dates, names, versions
9. No opinions or speculation, only facts from the source
10. Skip content that is outdated, trivial, or not worth preserving

REPORT: When done, list all files created or updated with their category and a one-line description.

Step 5: Review

After all sources are processed:

  1. Run python3 scripts/kb-index.py --write to regenerate kb/index.md's "All Files by Category" section from the current KB.
  2. Run python3 scripts/kb-validate.py to catch missing frontmatter, bad categories, or broken related: links.
  3. Run python3 scripts/kb-validate.py --max-age 90 (or a shorter window if the source changes faster) to surface entries that have drifted since their last refresh.
  4. Spot-check discoverability with python3 scripts/kb-search.py "<term the refresh should have covered>" to confirm new entries are searchable.
  5. Present a summary: X entries created, Y entries updated, from Z sources. Flag any warnings, errors, or stale entries.
  6. Ask the user if they want to add more sources or are done.

© techwolf-ai, 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 plugins/knowledge-base/skills/kb-refresh of techwolf-ai/ai-first-toolkit.

Open the folder on GitHubat commit 2ee7841

Compare with similar skills

Kb Refresh 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 Refresh compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kb Refresh this skilltechwolf-ai/ai-first-toolkit132—~1.3kAutomated safety check: PassMIT
Enterprise SearchZhixiangLuo/10xProductivity478—~535Automated safety check: PassMIT
Knowledge Base ArchitectFerroxLabs/wayland608—~4.1kAutomated safety check: PassApache-2.0
Firecrawl Knowledge Basefirecrawl/skills115—~612Automated safety check: PassISC
Cf Crawldavila7/claude-code-templates32k—~2.6kAutomated safety check: NotesMIT
LLM Wiki Knowledge GraphEgonex-AI/Understand-Anything85k1 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Enterprise Search

    ZhixiangLuo/10xProductivity

    Search your entire company's institutional knowledge in one query — Slack, Confluence, Jira, Linear, Notion, GitHub, plus any AI or multi-source search tool listed in verifiedconnections.md.

    478 GitHub stars~535 tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed
  • Knowledge Base Architect

    FerroxLabs/wayland

    Internal knowledge management expert covering documentation structure design, wiki architecture (Confluence, Notion, GitBook), information taxonomy, search optimization, content governance…

    608 GitHub stars~4.1k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Firecrawl Knowledge Base

    firecrawl/skills

    Build a knowledge base from web content with Firecrawl. An agent skill from firecrawl/skills.

    115 GitHub stars~612 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Cf Crawl

    davila7/claude-code-templates

    Crawl entire websites using Cloudflare Browser Rendering /crawl API.

    32k GitHub stars~2.6k tokensUpdated today
    Knowledge ManagementAuto-check: notes
  • LLM Wiki Knowledge Graph

    Egonex-AI/Understand-Anything

    Detects a Karpathy-pattern LLM wiki and builds an interactive knowledge graph with entities, implicit relationships and topic clusters.

    85k GitHub starsUsed in 1 repo~1.5k tokens
    Knowledge ManagementAuto-check passed
  • Turn a folder of Markdown notes (Obsidian vault, Notion export, plain repo docs) into a navigable static HTML knowledge base bundled as a single .zip file.

    210 GitHub stars~1.4k tokensUpdated 14 days ago
    Knowledge ManagementAuto-check passed

More from techwolf-ai/ai-first-toolkit

All 29 skills in this repo
  • Task Profile

    techwolf-ai/ai-first-toolkit

    Mine the user's Claude Code + Cowork session history into a structured task profile, what they do with AI, how often, how successfully where friction lives, then propose atomic skills that would…

    132 GitHub stars~3.6k tokensUpdated 8 days ago
    Auto-check passed
  • Token Doctor

    techwolf-ai/ai-first-toolkit

    Personal diagnosis of where your Claude Code + Cowork spend goes.

    132 GitHub stars~4.1k tokensUpdated 8 days ago
    Auto-check passed
  • Session Search

    techwolf-ai/ai-first-toolkit

    Find context from past Claude Code (CLI) and Claude Cowork (desktop) sessions on this Mac.

    132 GitHub stars~1.1k tokensUpdated 8 days ago
    Auto-check passed
  • Write Blog Post

    techwolf-ai/ai-first-toolkit

    Write or develop a blog post. An agent skill from techwolf-ai/ai-first-toolkit.

    132 GitHub stars~1.1k tokensUpdated 8 days ago
    Auto-check passed
  • Write Opinion

    techwolf-ai/ai-first-toolkit

    Write or develop an opinion piece (opiniestuk/op-ed). An agent skill from techwolf-ai/ai-first-toolkit.

    132 GitHub stars~695 tokensUpdated 8 days ago
    Auto-check passed
  • AI Firstify

    techwolf-ai/ai-first-toolkit

    Analyze, re-engineer, or bootstrap projects to align with AI-first design principles.

    132 GitHub stars~646 tokensUpdated 8 days ago
    Auto-check passed

Questions about Kb Refresh

What does Kb Refresh do?

Add new sources to your knowledge base or re-scrape existing ones to pick up changes. Kb Refresh is an agent skill from techwolf-ai/ai-first-toolkit. Add new sources to your knowledge base or re-scrape existing ones to pick up changes.

When should I use Kb Refresh?

Kb Refresh fits situations like: tasks that involve Web scraping; tasks that involve Knowledge bases.

How do I install Kb Refresh in Claude Code?

Run `npx skills add techwolf-ai/ai-first-toolkit --skill kb-refresh -a claude-code`. Or copy the skill folder (plugins/knowledge-base/skills/kb-refresh in techwolf-ai/ai-first-toolkit) into .claude/skills/kb-refresh in your project. Claude Code loads it when a task matches its description.

How do I install Kb Refresh in Codex?

Run `npx skills add techwolf-ai/ai-first-toolkit --skill kb-refresh -a codex`. Or copy the skill folder (plugins/knowledge-base/skills/kb-refresh in techwolf-ai/ai-first-toolkit) into .agents/skills/kb-refresh in your project. Codex loads it when a task matches its description.

Can I use Kb Refresh 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 techwolf-ai/ai-first-toolkit --skill kb-refresh -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-refresh, .gemini/skills/kb-refresh, .github/skills/kb-refresh and .opencode/skills/kb-refresh in your project.

What does Kb Refresh need to run?

Going by SKILL.md and its folder, Kb Refresh needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

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

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

About 1.3k tokens (SKILL.md is roughly 5.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 Refresh?

Skills that share tags, products or a category with Kb Refresh: Enterprise Search (ZhixiangLuo/10xProductivity, 478 stars), Knowledge Base Architect (FerroxLabs/wayland, 608 stars), Firecrawl Knowledge Base (firecrawl/skills, 115 stars) and Cf Crawl (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kb Refresh?

techwolf-ai (a GitHub organization) maintains it in techwolf-ai/ai-first-toolkit, which has 132 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on September 29, 2026.

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