Technical Documentation

---

name: Technical Documentation description: This skill should be used when the user asks to "write documentation", "create README", "API docs", "design document", "specification", "user guide", or needs documentation guidance. Provides comprehensive documentation patterns for developers, teams, and end-users in both English and Japanese.

[]

Brief one-line description of what the project does.

• Feature 1
• Feature 2
• Feature 3

npm install package-name

import { example } from "package-name";

const result = example();
console.log(result);

See full documentation for detailed guides.

Contributions welcome! See CONTRIBUTING.md.

MIT

All requests require an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

https://api.example.com/v1

<get_users>

Retrieve a list of users.

Parameters:

• limit (integer, optional): Number of results (default: 10)
• offset (integer, optional): Pagination offset (default: 0)

Response:

{
  "users": [
    { "id": 1, "name": "John Doe" },
    { "id": 2, "name": "Jane Smith" }
  ],
  "total": 100
}

Error Codes:

• 401: Unauthorized - Invalid API key
• 429: Rate limit exceeded

Problem: Brief description of the problem being solved Solution: High-level approach Scope: What's included and what's not

Context and motivation for this design.

Goals:

• Goal 1
• Goal 2

Non-Goals:

• What we're explicitly not doing
• Future considerations

[Diagram or description of system architecture]

1. User action
2. System processing
3. Response

Component A: Responsible for X Component B: Responsible for Y

<alternative 1>

Pros: ... Cons: ... Decision: Not chosen because...

• Data encryption at rest and in transit
• Authentication and authorization
• Input validation

• Unit tests for component logic
• Integration tests for API contracts
• E2E tests for critical user flows

1. Phase 1: Internal testing
2. Phase 2: Beta release (10% of users)
3. Phase 3: Full rollout

Welcome! This guide will help you get started with [Product Name].

Workspace: A container for your projects Project: A collection of related items Item: The basic unit of work

1. Click the "New Project" button
2. Enter a project name
3. Choose a template (optional)
4. Click "Create"

You'll see your new project in the sidebar.

<troubleshooting_login>

1. Check your email address is correct
2. Click "Forgot Password" to reset
3. Contact support if the issue persists

<troubleshooting_data>

Ensure you have a stable internet connection. The app auto-saves every 30 seconds.

Term: Definition Another Term: Another definition

<best_practices> Audience-first approach - Write for your specific audience's knowledge level Developers: Assume technical background, focus on implementation details Team members: Balance context with technical depth End users: Avoid jargon, use step-by-step instructions

<language_guidelines>

Professional but approachable Unnecessarily complex words, idioms that don't translate

<good_example>Good</good_example>

Run this command to start the server.

<bad_example>Bad</bad_example>

The server can be started by running the following command.

<bad_example>Bad</bad_example>

サーバーの起動については、下記コマンドを実行することで可能となります。

• Type: [readme/api_spec/design_doc/user_guide]
• Audience: [developer/team/end_user]
• Language: [en/ja/both]

[Proposed sections based on document type]

[Actual documentation content]

• Technical accuracy verified
• Code examples tested
• Links working
• Appropriate for audience
• Grammar and spelling checked

<anti_patterns> Long paragraphs without formatting Break into smaller paragraphs, use bullet points, headings, and code blocks

<error_escalation> Minor formatting inconsistency Fix formatting, follow style guide Outdated information detected Update content, verify with code Incorrect technical information Stop, verify with implementation before publishing Security-sensitive information exposed Block publication, require security review </error_escalation>

<related_agents> Requirements analysis and documentation structure planning Technical documentation writing and generation Documentation deployment and publishing tasks Fixing broken links, outdated examples, and documentation inconsistencies </related_agents>

<related_skills> Symbol operations for extracting code examples and API signatures Library documentation lookup for accurate API references Analyzing codebases to understand features for documentation Creating blog posts and tutorials from documentation </related_skills>