azukiazusa1/sapper-blog-app / .claude/skills/article-review
article-review
Verified引数で指定した記事のレビューを行います。記事スラッグを引数に渡すと、textlint による自動校正と誤字脱字・文法的な誤りの指摘を行います。/article-review [スラッグ] の形式で呼び出してください。記事を書いた後のチェック、公開前の校正、文章の品質確認にも使用してください。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| agents/openai.yaml | config | 319 B |
| references/editorial-checklist.md | markdown | 2.0 KB |
| references/notation-rules.md | markdown | 978 B |
references/editorial-checklist.md
View on GitHub# 技術記事の編集チェックリスト
該当する項目だけを適用し、読者への影響がある差を指摘する。
## メタデータと導入
- タイトルが技術と具体的な価値を示している
- `about` が背景、対象技術、読者の到達点を 2〜3 文で具体的に示している
- 導入が問題、変化、または実用的な結果から始まる
- 実験的な機能や重大な制約が、読者が手順へ進む前に示されている
## 構成と説明
- 前提、従来の方法、最小例、実用例の順序が自然である
- 見出しが実装内部の分類ではなく、読者の疑問や作業に沿っている
- 各段落が 1 つの主要な考えを進めている
- 原因、操作、結果の関係が明確である
- 抽象的な説明の後に必要な具体例がある
## コードと媒体
- コードの前に目的、後に重要な行と観測結果がある
- 静的な見た目、動き、操作に適切な媒体か `TODO(media)` コメントがある
- ローカルの媒体は `npm run upload:media` が処理できる `` または `!v(パス)` で参照し、ファイルがある媒体を `TODO(media)` コメントの中に書いていない
- 媒体の前で見るべき点、後で確認できる結果を説明している
- 代替テキストとキャプションが内容を説明している
- 内部検証成果物のパス、ディレクトリ、起動コマンド、公開されないサンプルへ言及していない
## 言語と終わり方
- 日本語と英数字、数値、単位、インラインコードの間に半角スペースがある
- 同じ概念に同じ用語を使い、公式名称を維持している
- `です`・`ます` 調と筆者固有の語調が一貫している
- `## まとめ` が本文の具体的な結論を箇条書きで再掲している
- `## 参考` に一次情報があり、本文中の主張からも根拠へリンクしている
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |