bri-tech-writer

Generates technical documentation, Mermaid diagrams, and explanations through a persona-driven writing workflow.

3|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/stellar-zk/stellar-zk --skill bri-tech-writer-stellar-zk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bri-tech-writer
Source: https://github.com/stellar-zk/stellar-zk/tree/main/.claude/skills/bri-tech-writer
Command: npx skills add https://github.com/stellar-zk/stellar-zk --skill bri-tech-writer-stellar-zk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping project documentation accurate, structured, and audience-appropriate is time-consuming, and teams often lack a consistent process for writing docs, diagrams, and explanations. This Skill provides a dedicated technical writer persona that authors documents, validates existing documentation, and produces diagrams on demand. ## Core Features & Use Cases - Document Authoring: Guides multi-turn conversations to draft well-structured documents following documentation best practices. - Mermaid Diagram Generation: Creates flowcharts, sequence diagrams, ER diagrams, and more in valid Mermaid syntax. - Documentation Validation: Reviews documents against standards and returns prioritized, actionable improvement suggestions. - Concept Explanation: Produces clear technical explanations with examples and diagrams tailored to the target audience. - Use Case: After finishing a new feature, ask the Skill to document the architecture, generate a sequence diagram of the request flow, and validate the README against best practices. ## Quick Start Ask Bri to document this codebase or write a technical explanation of a concept you are working on.

Frequently Asked Questions about bri-tech-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate technical documentation for my codebase?▼

Invoke the Skill and select the documentation menu option, which runs a brownfield analysis and architecture scan of the project. The Skill then drafts structured documentation following task-oriented writing best practices.

How do I create a Mermaid diagram from a description?▼

Choose the diagram menu option and describe what you want to visualize. The Skill suggests a diagram type such as flowchart, sequence, class, or ER, then generates valid Mermaid syntax in a fenced code block and iterates on your feedback.

Can this Skill review and validate existing documentation?▼

Yes, the validation capability reads a specified document and reviews it against documentation standards, clarity, structure, and audience fit. It returns a prioritized list of specific, actionable improvement suggestions.

How do I customize the persona and menu behavior?▼

Create override TOML files under .stellar-build/custom in your project named after the skill, with optional .user.toml for personal settings. Scalars override, tables deep-merge, and menu items merge by code.

Does the Skill verify Stellar blockchain facts?▼

When the stellar-raven MCP server is connected, the Skill queries it for Stellar protocol, SDK, and ecosystem facts before asserting them. Without it, the Skill flags unverified Stellar claims and continues with its built-in knowledge.