techwriter

Updates Russian-language project documentation, OpenAPI descriptions, and error message texts for AI Billing.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/lfuuu/claude-rules --skill techwriter-lfuuu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: techwriter
Source: https://github.com/lfuuu/claude-rules/tree/main/ai-billing/skills/techwriter
Command: npx skills add https://github.com/lfuuu/claude-rules --skill techwriter-lfuuu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Keeping project documentation in sync with a fast-moving codebase is tedious and error-prone. This Skill enforces a dedicated technical-writer role that updates docs/, README, OpenAPI descriptions, and BillingError message texts in Russian whenever the API, business logic, MVP stage, or demo flow changes—without ever touching business code. ## Core Features & Use Cases - Scoped write access: Edits only docs/*.md, README.md, Russian descriptions in backend/src/api/openapi/, and error.message texts of BillingError; business code, error codes, and JSON response shapes are strictly off-limits. - Trigger-based invocation: Called when the public API, business logic, MVP stage, demo flow, or project rules/workflow change, updating spec.md, status.md, demo.md, CLAUDE.md, and AGENTS.md accordingly. - Language discipline: All prose in Russian with English identifiers preserved; forbids mixed-language blocks and mass translation passes. - Use Case: After the backend role adds a new billing endpoint, invoke this Skill to update the OpenAPI descriptions and docs/spec.md in Russian, then receive a report listing changed files and intentionally untouched adjacent documents. ## Quick Start Invoke the techwriter role to update docs/spec.md and the OpenAPI descriptions after the recent API change, keeping all prose in Russian.

Frequently Asked Questions about techwriter

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

FAQPage Schema
How do I keep API documentation in sync with code changes?

Invoke this Skill whenever the public API or business logic changes. It updates OpenAPI descriptions and docs/spec.md in Russian, then reports which files changed and which adjacent documents were intentionally left untouched.

What files can a technical writer role edit in a TypeScript project?

This role edits docs/*.md, README.md, Russian descriptions in backend/src/api/openapi/, and error.message texts of BillingError. It never modifies business code in backend/src or frontend/src, error codes, or JSON response shapes.

Can this Skill change error codes or API response formats?

No. Changing error.code values, JSON field names, or response shapes is explicitly forbidden and belongs to the backend role. The techwriter may only edit the human-readable message text of BillingError.

When should I not use a documentation writer role?

Do not invoke it to fix business code, migrations, or tests—use the backend or frontend roles instead. It is also not meant for mass translation of the repository in a single pass.

Does it support mixed Russian and English documentation?

No. All prose must be in Russian while identifiers stay in English. When editing an English block, it translates the whole block within the same change and never leaves mixed-language content.