Reviews and advises on documentation structure, style, curation, and Mermaid diagrams.
npx skills add https://github.com/psmfd/pi-config --skill docs-expert-psmfd
Please help me install this Agent Skill. Skill: docs-expert Source: https://github.com/psmfd/pi-config/tree/main/agent/skills/docs-expert Command: npx skills add https://github.com/psmfd/pi-config --skill docs-expert-psmfd
High-intent search queries and answers about installing and using this skill.
Invoke the docs-expert skill against the document to get findings on heading hierarchy, format choice, tone, and audience targeting. It reports issues structurally and defers any domain policy substance to the relevant domain expert.
Apply the Claudish anti-pattern catalogue in references/style.md: remove hedging stacks, filler transitions, jargon stacking, and marketing adjectives. The rewrite contract requires preserving every fact, code block, heading structure, and claim strength.
Use flowcharts for processes, sequence diagrams for request/response flows, state diagrams for lifecycles, and ER diagrams for data models. Keep diagrams under 20 nodes and label edges with the action or data being passed.
Azure DevOps wiki renders Mermaid, but the bundled version trails the latest release by 6-12 months. Newer diagram types like mindmap, timeline, and sankey may not render, so stick to flowchart, sequence, class, state, ER, Gantt, and pie.
It is read-only and never modifies files directly. It cannot rule on the substance of technical rules, conventions, or policies; that content is always deferred to the relevant domain expert, and it never drafts candidate policy text.
bordenetExtract domain knowledge from experts via structured interviews into reviewed artifacts.
shinprUpdates existing design documents, PRDs, and ADRs with review and consistency verification.
highflame-aiAnalyze git diffs with multi-agent code reviews for correctness, architecture, and security.
raystyleLint and fix Markdown files with markdownlint using Bun.
