| name | docs-lookup |
| description | Look up Buttondown documentation in the local cache before answering API questions or making API calls. Use grep/read against $CLAUDE_USER_DATA/buttondown-mgmt/cache/docs to ground responses in the canonical docs rather than training-data recall. |
Docs Lookup
Always consult the cached docs before:
- Answering "how do I X with Buttondown" questions
- Constructing API requests (endpoint, payload shape, auth header)
- Recommending CLI invocations
Steps
DOCS_DIR="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/buttondown-mgmt/cache/docs"
If $DOCS_DIR is missing or stale (>14 days since docs_last_refresh in config.json), run refresh-docs first.
Search with grep -ril <keyword> "$DOCS_DIR", then Read the most relevant files. Cite file paths in answers so the user can verify.
If the docs do not cover the topic, say so explicitly rather than improvising — and consider whether the upstream docs need a doc-bug report.