championswimmer avatar

tech-doc-skills

v0.1.0

by championswimmer

Portable agent plugin with reusable skills for Mermaid diagrams and technical web research, plus bundled MCP server definitions for Exa, Parallel Search, Perplexity, and Context7.

What tech-doc-skills does, in the publisher's words

Portable agent skills for writing technical docs and RFCs.

This repo is the canonical source for two reusable skills:

  • mermaid-diagrams: write, style, template, and validate Mermaid diagrams for architecture notes, RFCs, ADRs, and READMEs
  • web-research: gather current technical evidence with a clear query strategy, source-quality rules, and failover across search tools

These skills are designed to work with Claude Code, OpenAI Codex, OpenCode, and Pi through the same canonical skills/ tree.

From the project README, punctuation lightly normalized · Open the README on GitHub

Skills
2
MCP servers
4
Stars
0
License
MIT
Repo created
2026-06-14
Last pushed
2026-08-17
Publisher type
User
Version
0.1.0

Links

Skills · 2

mermaid-diagrams
Use this skill when asked to create, fix, review, or validate Mermaid diagrams in technical docs, RFCs, ADRs, architecture notes, or Markdown. Helps choose the right Mermaid diagram type, apply consistent semantic colors and groups, and validate diagrams before finalizing.
web-research
Use this skill for current, source-backed technical research for docs, RFCs, ADRs, release notes, API usage, benchmarks, comparisons, or ecosystem questions. Best when Exa, Parallel Search, Perplexity, and Context7 MCP tools are available.

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

MCP servers · 4

context7stdio
npx -y @upstash/context7-mcp@latest
exastdio
npx -y exa-mcp-server
env vars: EXA_API_KEY
parallel-searchstreamable-http
https://search.parallel.ai/mcp
perplexitystdio
npx -y @perplexity-ai/mcp-server
env vars: PERPLEXITY_API_KEY

Read from the plugin's own mcp.json. We list environment variable names, never values.

Category

Research & Search. Assigned by this directory. Agent Plugins 1.0.0 has no category field, so no manifest declares one.

Keywords

agent-plugins · claude-code-plugin · skills · mermaid · web-research · mcp · docs · rfc

Related by publisher and keywords

  • graphflowRoarpeng

    图谱上下文压缩与任务规划插件(10 个 MCP 工具)。能力:压缩上下文、DAG 规划、增量建图、技能飞轮、诊断与产物导入导出。DeepSeek Harness:dsh plugin --profile web add @roarpeng/graphflow;工具名为 mcp__graphflow__graphflow_*。先调 graphflow_context(传 rootDir),复杂任务再 plan,改完代码后 index。

  • MCP server for local markdown: search, extract sections, headings, code blocks, and frontmatter.

  • context7HiAi-gg

    Current library and framework documentation via Context7's first-party MCP server, with usage-discipline skills for when an agent should consult it.

  • agent-pluginsthimslugga

    Personal agent plugins

  • Portable Agent Plugins v1 specification spike for the agents-wom plugin home.

  • 基于 Agent Plugins Specification v1.0.0 的中文实践示范仓库:通过高质量 Skill、MCP 及二者组合案例,展示 Agent Plugin 的设计、组织、运行与复用。

Add the verified badge to your README[![Verified by AgentPluginsDirectory.com against Schema 1.0.0](https://agentpluginsdirectory.com/badge.svg)](https://agentpluginsdirectory.com/plugins/tech-doc-skills)

✓ Verified . We fetched the manifest from GitHub and checked it against the official Agent Plugins 1.0.0 schema at agent-plugins.org.