documentation-and-adrs
A skill from Addy Osmani's agent-skills collection for recording why code is the way it is.
スキルの内容
A skill from Addy Osmani's agent-skills collection for recording why code is the way it is. When the agent makes an architectural decision, changes a public API or ships user-facing behaviour, it writes an architecture decision record, first matching any existing ADR folder, numbering and headings, and otherwise using the skill's template with context, decision, alternatives and consequences. It also covers when inline comments are worth adding and when not, API documentation through typed doc comments or OpenAPI, a README outline, keeping a changelog, documentation written for agents, and a final prose review.
できること
- Write architecture decision records matching existing conventions
- Document public APIs with doc comments or OpenAPI
- Outline a README and maintain a changelog
- Decide when inline comments are needed
概要
- 公開元
- Addy Osmani
インストール
プロジェクトのドキュメントに、確認できるインストール手順がありません。 プロジェクトの手順を見る
MCPサーバーやスキルは、お使いのコンピューターでコードを実行したり、データを操作したりできます。インストールする前にソースを確認してください。
詳細
| 項目 | 内容 | 出典 |
|---|---|---|
| 種類 | スキル | |
| ツール | Documentation | |
| 公開元 | Addy Osmani | 出典 |
| 公式かどうか | ドキュメントに記載なし | |
| APIキーまたはサインインが必要 | ドキュメントに記載なし | |
| スクリプトを含む | いいえ | 出典 |
| プラットフォーム | ドキュメントに記載なし | |
| AIクライアント | ドキュメントに記載なし | |
| ライセンス | MIT | 出典 |
| 料金 | ドキュメントに記載なし | |
| 活動状況 | 最終コミット 2026年11月18日GitHubスター 118,985ダウンロード数のデータなし(npm・PyPIで未公開) | 出典 |
| リンク | リポジトリ Webサイト |
出典
- スキルファイル(SKILL.md)github.com/addyosmani/agent-skills2026年11月19日
- ライセンスファイル(LICENSE)github.com/addyosmani/agent-skills · 根拠となる項目:ライセンス2026年11月12日
- GitHubリポジトリgithub.com/addyosmani/agent-skills · 根拠となる項目:公開元, 活動状況, ライセンス2026年11月19日
- リポジトリ内のフォルダ(documentation-and-adrs)github.com/addyosmani/agent-skills · 根拠となる項目:スクリプトを含む2026年11月19日