---
title: "tech-doc-skills"
description: "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."
canonical: https://agentpluginsdirectory.com/plugins/tech-doc-skills
last-updated: 2026-11-13
---

# tech-doc-skills
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.
## Package we checked
plugin.json sits at the package root in championswimmer/tech-doc-skills, which is the plugin directory the 1.0.0 spec describes. Its $schema is https://agent-plugins.org/schemas/1.0.0/plugin.schema.json. The manifest lists 2 skills (mermaid-diagrams, web-research) and 4 MCP servers (context7, exa, parallel-search, perplexity). Stored mcp.json transports: context7 stdio, perplexity stdio, parallel-search streamable-http, exa stdio.
- Slug: tech-doc-skills
- Publisher: championswimmer
- Repository: https://github.com/championswimmer/tech-doc-skills
- Manifest: plugin.json
- Version: 0.1.0
- License: MIT
- Category (editorial): research
- Skills: 2 (mermaid-diagrams, web-research)
- MCP servers: 4 (context7, exa, parallel-search, perplexity)
- Stars: 0
- Repository created: 2026-06-14
- Repository last pushed: 2026-08-17
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/tech-doc-skills
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## 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. Full text: https://raw.githubusercontent.com/championswimmer/tech-doc-skills/HEAD/README.md

## Skills

- 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

- context7: transport: stdio; command: npx -y @upstash/context7-mcp@latest
- exa: transport: stdio; command: npx -y exa-mcp-server; env: EXA_API_KEY
- parallel-search: transport: streamable-http; url: https://search.parallel.ai/mcp
- perplexity: transport: stdio; command: npx -y @perplexity-ai/mcp-server; env: PERPLEXITY_API_KEY

Read from the plugin's own mcp.json. Environment variable names only, never values.
