Agent skill · software engineering · aiskillstore
scribe-mcp-usage
Operate the local Scribe MCP for any ~/projects/* repo; use when registering the server, setting projects, drafting ARCH/PHASE/CHECKLIST via manage_docs, or logging work with append_entry/get_project safeguards.
Why this skill is useful
Provides specific commands and usage patterns for operating the Scribe MCP that the AI wouldn't reliably generate on its own.
What it needs
About 10k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
✅ 2.1.1 Tool Usage Quick Reference (Read First) Use this section before any edits. It defines when and how to use the new doc-lifecycle tools. Always set project first: setproject(name=..., root=/abs/path/to/repo). All doc actions require a project registry. Doc keys are strict: Structural actions validate doc against project["docs"]. Unknown docs fail with DOCNOTFOUND (no healing). applypatch (structured default): Use for most edits. Provide edit payloads (replacerange / replaceblock / replacesection). Ambiguous anchors fail with line lists; code fences are ignored in replaceblock. replacerange: Use when you already have body-relative line numbers (frontmatter excluded). normalizeheaders: Run before TOC. Supports ATX with/without space and Setext (====/----). Skips fenced code blocks. Idempotent. generatetoc: Run after normalization. Inserts/replaces <!-- TOC:start -->/<!-- TOC:end -->. Uses GitHub-style anchors (NFKD normalization, ASCII folding, emoji removal, punctuation collapse, de-duped suffixes). Idempotent. createdoc: Create custom docs from content or metadata.body/snippet/sections. Users do not supply Jinja. Multiline bodies are preserved. Use metadata.registerdoc=true only if the doc should be added to the registry (one-off docs can stay unregistered). validatecrosslinks: Read-only diagnostics. Optional metadata.checkanchors=true for anchor checks. No writes, no docupdates logs. Line numbers are body-relative: Frontmatter does not count toward line math. listsections/listchecklistitems return body-relative line numbers plus bodylineoffset for mapping. readfile: Use repo-scoped scan/chunk/page/search modes for safe reads; every read logs provenance automatically. scribedoctor: Use for readiness diagnostics (repo root, config paths, plugin status, vector readiness). managedocs search (semantic): Use action="search" + searchmode="semantic" for doc/log semantic retrieval. Default results are doc-first with clear contenttype labels. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/scribe-mcp-usage