Skill 詳細

technical-writing

Direct skill for docs, READMEs, API docs, and guides.

一致度直接一致テクニカルライティング向けにレビュー済み

出典pp-namias/portfolio外部ソース

報告インストール数1人気度の参考値

使用前に確認

自動レビューは関連性のみを確認し、安全性や推奨を保証しません。使用前に出典の説明を読んでください。

skills.sh で見る（外部ページ）GitHub で SKILL.md を読む（外部ページ）

保存された出典プレビュー

SKILL.md

これはレビュー時に保存された抜粋です。完全で最新の内容は外部ソースを確認してください。

---
name: technical-writing
description: Create clear, concise technical documentation, READMEs, and guides.
---

# Technical Writing Skill

Write high-quality technical documentation, README files, API docs, and developer guides.

## When to use this skill

- Writing or updating README files
- Creating API documentation
- Writing developer guides
- Creating architecture decision records (ADRs)
- Updating AGENTS.md and skill files

## Workflow

1. **Understand audience** — Developers, users, or stakeholders
2. **Outline structure** — Organize content logically
3. **Write clearly** — Use simple language, avoid jargon
4. **Add examples** — Code samples and use cases
5. **Review and iterate** — Get feedback and improve

## Documentation Structure

```markdown
# Title

Brief description of what this is.

## Features

- Feature 1
- Feature 2

## Installation

\`\`\`bash
npm install package-name
\`\`\`

## Usage

\`\`\`typescript
import { thing } from 'package-name';

// Example usage
\`\`\`

## API Reference

### function name()

Description of the function.

**Parameters:**
- `param1` (type) - Description
- `param2` (type) - Description

**Returns:** type - Description

## Contributing

Guidelines for contributors.

## License

License information.
```

## Writing Tips

- Use active voice
- Keep sentences short
- Use code blocks for commands
- Add diagrams for complex concepts
- Keep documentation up-to-date
- Use consistent terminology

## Checklist

- [ ] Clear title and description
- [ ] Installation instructions
- [ ] Usage examples
- [ ] API documentation
- [ ] Contributing guidelines
- [ ] Links to related docs

GitHub で全文を読む