Clawd-Docs v2.0 - Smart Documentation Access

This skill provides intelligent access to ClawdBot documentation with:

• Local search index - instant keyword lookup (0 tokens)
• Cached snippets - pre-fetched common answers (~300-500 tokens)
• On-demand fetch - full page when needed (~8-12k tokens)
• Freshness tracking - TTL per page type

---

Credits

• Inspired by Clawdbot Documentation Expert by @NickSpisak_
• Built collaboratively by Claude Code + Clawd

---

Quick Start

Step 1: Check Golden Snippets First

Before fetching anything, check if a Golden Snippet exists:

ls ~/clawd/data/docs-snippets/

Available snippets (check cache first!):

Snippet	Query matches
telegram-setup.md	"ako nastaviť telegram", "telegram setup"
telegram-allowfrom.md	"allowFrom", "kto mi môže písať", "access control"
oauth-troubleshoot.md	"token expired", "oauth error", "credentials"
update-procedure.md	"ako updatnuť", "update clawdbot"
restart-gateway.md	"restart", "reštart", "stop/start"
config-basics.md	"config", "nastavenie", "konfigurácia"
config-providers.md	"pridať provider", "discord setup", "nový kanál"

Read snippet:

cat ~/clawd/data/docs-snippets/telegram-setup.md

Step 2: Search Index (if snippet doesn't exist)

Check ~/clawd/data/docs-index.json for page suggestions.

Keyword matching:

• "telegram" → channels/telegram
• "oauth" → concepts/oauth, gateway/troubleshooting
• "update" → install/updating
• "config" → gateway/configuration

Step 3: Fetch Page (if cache miss)

mcporter call brightdata.scrape_as_markdown url="https://docs.clawd.bot/{path}"

Example:

mcporter call brightdata.scrape_as_markdown url="https://docs.clawd.bot/tools/skills"

---

Search Index Structure

Location: ~/clawd/data/docs-index.json

{
  "pages": [
    {
      "path": "channels/telegram",
      "ttl_days": 7,
      "keywords": ["telegram", "tg", "bot", "allowfrom"]
    }
  ],
  "synonyms": {
    "telegram": ["tg", "telegrambot"],
    "configuration": ["config", "nastavenie", "settings"]
  }
}

Use synonyms for fuzzy matching.

---

TTL Strategy (Freshness)

Page Category	TTL	Why
install/updating	1 day	Always current!
gateway/*	7 days	Config changes
channels/*	7 days	Provider updates
tools/*	7 days	Features added
concepts/*	14 days	Rarely changes
reference/*	30 days	Stable templates

Check snippet expiry:

head -10 ~/clawd/data/docs-snippets/telegram-setup.md | grep expires

---

Common Scenarios

"Ako nastaviť Telegram?"

1. ✅ Read ~/clawd/data/docs-snippets/telegram-setup.md

"allowFrom nefunguje"

1. ✅ Read ~/clawd/data/docs-snippets/telegram-allowfrom.md

"Token expired / oauth error"

1. ✅ Read ~/clawd/data/docs-snippets/oauth-troubleshoot.md

"Ako updatnúť ClawdBot?"

1. ✅ Read ~/clawd/data/docs-snippets/update-procedure.md

"Ako pridať nový skill?" (nie je snippet)

1. Search index → tools/skills
2. Fetch: mcporter call brightdata.scrape_as_markdown url="https://docs.clawd.bot/tools/skills"

"Multi-agent routing"

1. Search index → concepts/multi-agent
2. Fetch full page (complex topic)

---

Fallback: Full Index Refresh

If you can't find what you need:

mcporter call brightdata.scrape_as_markdown url="https://docs.clawd.bot/llms.txt"

Returns complete list of all documentation pages.

---

Token Efficiency Guide

Method	Tokens	When to use
Golden Snippet	~300-500	✅ Always first!
Search Index	0	Keyword lookup
Full Page Fetch	~8-12k	Last resort
Batch Fetch	~20-30k	Multiple related topics

80-90% of queries should be answered from snippets!

---

Data Locations

~/clawd/data/
├── docs-index.json       # Search index
├── docs-stats.json       # Usage tracking
├── docs-snippets/        # Cached Golden Snippets
│   ├── telegram-setup.md
│   ├── telegram-allowfrom.md
│   ├── oauth-troubleshoot.md
│   ├── update-procedure.md
│   ├── restart-gateway.md
│   ├── config-basics.md
│   └── config-providers.md
└── docs-cache/           # Full page cache (future)

---

Version Info

Item	Value
Skill version	2.0.0
Created	2026-01-14
Authors	Claude Code + Clawd (collaborative)
Source	https://docs.clawd.bot/
Dependencies	brightdata skill (mcporter)
Index pages	~50 core pages
Golden snippets	7 pre-cached

---

Changelog

v2.0.0 (2026-01-14)

• 3-layer architecture: Search Index → Snippets → On-demand Fetch
• Golden Snippets pre-cached for common queries
• TTL-based freshness tracking
• Synonym support for fuzzy matching
• 80-90% token reduction for common queries

v1.0.0 (2026-01-08)

• Initial release with brightdata fetch only

---

This skill provides smart documentation access - always cached snippets first, fetch only when necessary.