Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/ofershap/mcp-server-markdown/markdown-searchnpx skills add ofershap/mcp-server-markdown --skill markdown-searchgit clone --depth 1 https://github.com/ofershap/mcp-server-markdownWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/ofershap/mcp-server-markdown/markdown-search)<a href="https://agentmods.dev/skills/ofershap/mcp-server-markdown/markdown-search"><img src="https://agentmods.dev/badge/skills/ofershap/mcp-server-markdown/markdown-search.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00052 | $0.00494 |
| Opus 5 | $0.00026 | $0.00247 |
| Sonnet 5 | $0.00010 | $0.00099 |
| Haiku 4.5 | $0.00005 | $0.00049 |
Grade A, and why
markdown-search scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 42 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Markdown Search via MCP
Use this skill when you need to search documentation, extract sections, list headings, or find code blocks across local markdown files.
Available Tools
| Tool | What it does |
|---|---|
list_files |
List all .md files in a directory recursively |
search_docs |
Full-text search across all .md files (case-insensitive, up to 50 results) |
get_section |
Extract a section by heading until the next heading of same/higher level |
list_headings |
List all headings as a table of contents |
find_code_blocks |
Find fenced code blocks, optionally filter by language |
get_frontmatter |
Parse YAML frontmatter metadata from a file |
Workflow
list_filesto discover documentation files in the projectsearch_docsfor full-text search across all docslist_headingsto get the table of contents for a specific fileget_sectionto extract a specific section by its heading textfind_code_blocksto find code examples, optionally filtered by language
Key Patterns
get_sectionextracts everything under a heading until the next heading of same or higher levelfind_code_blockswithlanguage: "typescript"filters to only TS examplessearch_docsis case-insensitive and returns up to 50 matches with surrounding context- Unlike the filesystem MCP, this server understands markdown structure (headings, sections, code fences)
Error Scenarios
- No matches from
search_docs: widen the query, check the directory path, or confirm files use.mdextension get_sectionnot found: heading text must match (including#level); uselist_headingsfirst- Permission or missing path errors: verify the directory exists and is readable on the host running the MCP server
- More than 50 search hits: refine the query or search a smaller subdirectory
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 42 lines · 52 tokens per session scan A ec41d932c7a0
markdown-search is a skill published in the GitHub repository ofershap/mcp-server-markdown (5 stars, last pushed 25d ago), licensed MIT. It adds 52 tokens to every session and 494 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
ingest-l1
L1 analysis loop for the abapwiki knowledge base: for each batch it launches the abap-analyzer sub-agent in parallel, then the adversarial judge abap-deepcheck (separate session), applies only the analyses that pass the fail-closed gate, and commits. Resumes exactly after an interruption. Use this skill to document…
Incident Postmortem Writer
Writes a blameless incident postmortem document from an incident timeline or Slack thread.
write-gitbook
A comprehensive guide for editing GitBook documentation in external environments like Cursor, Claude Code, or other text editors. This skill provides all the formatting syntax, configuration options, and best practices needed to create and maintain GitBook content outside the GitBook web interface.
autoscaffold-content
Generate real starter content for a project's What-L2 (requirements) and How-L2 (architecture/conventions) CEP layers once ult-repo-layout has resolved their paths but found them empty — an honest, minimal, YAML-frontmatter-first overview document per layer for small/single targets, or graphify-informed per-module…
policy-drift-audit
Run the policy/process drift audit. Surfaces stale, superseded, duplicate, non-canonical, and conflicting policy documents using DocGraph's built-in drift engine. Presents findings and optional remediation suggestions without writing governance decisions.
vault
Generate an Obsidian LLM wiki vault from a project's source code and any static documents in raw/.