skills.rest
chrissstellee
chrissstelleeCOMMUNITY
Explore all skills by this author →
GitHub

bri-tech-writer

Generates technical documentation, Mermaid diagrams, and document validation through a customizable writer persona.

Updated Jul 26, 2026
Search Tags:#documentation#mermaid#validation#technical writing#toml#persona#diagrams
One-click install
npx skills add https://github.com/chrissstellee/Movix --skill bri-tech-writer-chrissstellee
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bri-tech-writer
Source: https://github.com/chrissstellee/Movix/tree/main/.agents/skills/bri-tech-writer
Command: npx skills add https://github.com/chrissstellee/Movix --skill bri-tech-writer-chrissstellee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams struggle to keep project documentation consistent, accessible, and up to date. This Skill activates Bri, a technical writer persona that authors documents, explains complex concepts, generates diagrams, and validates documentation against best practices. ## 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 existing documents against standards and returns prioritized, actionable improvement suggestions. - Customizable Persona: Merges base, team, and user TOML overrides to tailor tone, principles, and menu options per project. - Use Case: After finishing a codebase analysis, ask Bri to document the architecture — she scans the project, drafts structured docs with diagrams, and validates the output. ## Quick Start Ask Bri to document this codebase or generate a Mermaid diagram of your system architecture.

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 project documentation from an existing codebase?▼

Invoke the bri-tech-writer skill and select the DP menu option to generate comprehensive project documentation including brownfield analysis and architecture scanning. Bri scans project context files and drafts structured documentation.

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

Use the MG menu option or ask for a diagram directly. Bri clarifies what needs visualizing, suggests a diagram type such as flowchart, sequence, or ER, then generates valid Mermaid syntax in a fenced code block.

Can I customize the technical writer persona for my team?▼

Yes. Create override TOML files at .stellar-build/custom/bri-tech-writer.toml for team settings or bri-tech-writer.user.toml for personal settings. Scalars override, tables deep-merge, and menu items merge by code.

How do I validate documentation against best practices?▼

Select the VD menu option and specify the document to review. Bri analyzes structure, clarity, audience-appropriateness, and any focus areas you specify, then returns prioritized actionable improvement suggestions.

What are the limitations of the documentation validation feature?▼

Validation reviews documents against general documentation standards and user-specified focus areas, but it does not verify technical accuracy of the underlying code or systems described. Domain experts should still review factual claims.

Related Skills

Explore More Content & Communication Skills→
baobao0303baobao0303
1

harness-agent-tech-writer

Generate structured technical documentation grounded in repository context and configuration.

Community
Intermediate
lailtonjuniorlailtonjunior

Documentation

Generate and update Markdown and HTML documentation from code, schemas, and design notes.

Community
Intermediate
ClawStackStudiosClawStackStudios

Blueprint Weaver Meta-Skill

Coordinate agents to scan codebases and update architectural documentation.

Community
Intermediate
mei28mei28
3

doc-gen

Generate OpenAPI specs and Markdown API references from codebases.

Community
Advanced