Agent skill

Documentation Criteria

by shinpr in shinpr/ai-coding-project-boilerplate

変更に必要なPRD、ADR、UI Spec、Design Doc、作業計画書と、それぞれの保存先を判定する。ドキュメントの範囲を決める時、または技術ドキュメントを作成・レビューする時に使用。

MITAuto-check passedDevelopment

Install Documentation Criteria

skills CLI
$ npx skills add shinpr/ai-coding-project-boilerplate --skill documentation-criteria -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shinpr/ai-coding-project-boilerplate documentation-criteria --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shinpr/ai-coding-project-boilerplate.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills-ja/documentation-criteria .claude/skills/documentation-criteria && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
documentation-criteria
GitHub stars
233
Token cost
~865 tokens
SKILL.md length
109 words
Files
7 (incl. references)
Skills in repo
41
Repo updated
First seen
Licence
MIT

At a glance

変更に必要なPRD、ADR、UI Spec、Design Doc、作業計画書と、それぞれの保存先を判定する。ドキュメントの範囲を決める時、または技術ドキュメントを作成・レビューする時に使用。

  • Works in 2 steps: 選択に判断を要する —… → 選択が後続作業に長く影響する —…
  • Tasks that involve Architecture decision records
  • SKILL.md covers 各ドキュメントで確定すること, 作成判定マトリクス, 構造スケール and ADR判定フィルタ, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Documentation Criteria is an agent skill from shinpr/ai-coding-project-boilerplate. 変更に必要なPRD、ADR、UI Spec、Design Doc、作業計画書と、それぞれの保存先を判定する。ドキュメントの範囲を決める時、または技術ドキュメントを作成・レビューする時に使用。

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/adr-template.md`, `references/design-template.md` and `references/plan-template.md`).

It sits in Development, covering Architecture decision records and PRD writing. The repository describes itself as: Agentic coding TypeScript boilerplate for Claude Code: sub-agent workflows with built-in quality checks and context engineering. The licence is MIT.

When your agent uses it

  • Tasks that involve Architecture decision records
  • Tasks that involve PRD writing

Example prompts

  • “/documentation-criteria”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. 選択に判断を要する — 確認済み要件、承認済みの判断、リポジトリの代表的なエビデンスを適用した後も、妥当かつ実質的に異なる選択肢が2つ以上残る。
  2. 選択が後続作業に長く影響する — 選択によって、後続作業が維持または理解すべき責務、依存方向、共有契約、永続化、技術、可逆性、ライフサイクルコストのいずれかが実質的に変わる。

What it can do on your machine

Read from SKILL.md and the folder at commit 56913a2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Documentation Criteria loads about 865 tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 30 tokens; SKILL.md has 109 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~865
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shinpr/ai-coding-project-boilerplate at commit 56913a2, republished under its MIT licence (© shinpr). 109 words, ~865 tokens.

Download SKILL.mdSave it as .claude/skills/documentation-criteria/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
documentation-criteria
description
変更に必要なPRD、ADR、UI Spec、Design Doc、作業計画書と、それぞれの保存先を判定する。ドキュメントの範囲を決める時、または技術ドキュメントを作成・レビューする時に使用。

ドキュメント作成基準

このスキルはドキュメントの振り分け、すなわち変更に伴って記録すべき、後続作業に長く影響する判断と各ドキュメントの保存先を定める。各ドキュメントの内容と構造の要件は、「保存場所」からリンクされた各テンプレートが定める。

各ドキュメントで確定すること

  • PRD — 後続作業のトレーサビリティの基点となるビジネス成果、現時点の要件、対象外、受入条件を確定する。AC IDは設計と検証で使う安定したトレーサビリティキーとする。実装設計はDesign Doc、技術的な選択肢の決定はADR、タスクの順序は作業計画書に記載する
  • ADR — 後続作業に長く影響する技術判断を1つと、それが退けた実質的に異なる選択肢を記録し、後続作業が承認済みの判断と偶発的な実装を区別できるようにする。Accepted は現時点で選ばれている手段を記録したものであり、維持する義務ではない。確認済みの成果、将来状態の要件、対象外を維持したまま、より小さく十分な選択を後のエビデンスが支持する場合は、そのADRを更新または置き換える。完全な実装設計はDesign Docに記載する
  • UI Spec — 実装前に画面構造、遷移、コンポーネントと状態の契約、インタラクション、ビジュアル受入条件を記録する。これらの判断が未確定の場合に限って作成する。承認済みのUI Specがある場合は再利用し、リポジトリの代表的なエビデンスから判断できる場合はDesign Docへ進む
  • Design Doc — 確認済みスコープに対する完全な実装設計として、責務、フロー、契約、変更影響、検証境界を記録する。実装では主要な技術基準として扱い、不足している実現方法を黙って作り出さない。リポジトリのエビデンスによって技術的な実現方法が成立しないと分かった一方で、確認済みの成果、将来状態の要件、対象外を維持できる場合は、プロダクト要件を再検討せず、担当するワークフローで実装と影響を受ける技術成果物を修正する
  • 作業計画書 — 依存順序、タスク境界、実行可能な検証、最初に有用な証明を得る地点を確定する。設計詳細は再掲せず参照する
  • タスクファイル — 作業計画書の実行可能な成果1つについて、根拠となる情報源、調査の開始地点、書き込み責務、観測可能な検証を実装へ引き継ぐ

作成判定マトリクス

構造スケール基本ドキュメント作成順序
小規模なし直接実装
中規模Design Doc、作業計画書Design Doc -> 作業計画書
大規模PRD、Design Doc、作業計画書PRD -> Design Doc -> 作業計画書

フロントエンドまたはフルスタックの作業でUIに関する判断が未確定の場合は、Design Docの前にUI Specを追加する。適格なADRバッチはDesign Docの前に完了させる。適格なADRがある場合、スケールは最低でも中規模とする。

大規模変更のPRD要件は、新規PRDの作成、関連PRDの更新、現行のプロダクト文書がない場合のリバースPRD作成のいずれかで満たす。どのスケールでも、プロダクトスコープが変わる場合は既存PRDを更新する。

構造スケール

分類するのはリポジトリ上のレイアウトではなく判断負荷である。ファイル数は補助的なエビデンスにとどまる。

スケール判断負荷
小規模まとまった成果が1つで、1つの責務境界の中にリポジトリの根拠がある明白な実装が1つあり、後続作業に長く影響する未解決の選択がない
中規模まとまった成果が1つで、境界の調整を伴うか、後続作業に長く影響しうる選択を含む
大規模独立して価値を持つ成果が複数あり、それぞれ別個の設計判断を要する

レイヤーをまたぐ実装であっても、まとまった成果1つに資する場合は中規模のままでよい。

ADR判定フィルタ

確認済みの実装スコープ内にある技術的な論点ごとに、選択(Choice)フィルタ、次いで長期影響(Durability)フィルタを適用する。新たな記録を作る前に、承認済みADRを確認する。

  1. 選択に判断を要する — 確認済み要件、承認済みの判断、リポジトリの代表的なエビデンスを適用した後も、妥当かつ実質的に異なる選択肢が2つ以上残る。
  2. 選択が後続作業に長く影響する — 選択によって、後続作業が維持または理解すべき責務、依存方向、共有契約、永続化、技術、可逆性、ライフサイクルコストのいずれかが実質的に変わる。

両方のフィルタを通過した論点ごとにADRを1つ作成し、バッチ全体をまとめてレビューする。一緒に選択または再検討しなければならない判断はまとめ、独立して再検討できる判断は分ける。ローカルな実装詳細や、安価に元へ戻せるその他の選択はDesign Docに記載する。

保存場所

ドキュメントパス命名規則テンプレート
PRDdocs/prd/[feature-name]-prd.mdprd-template.md
ADRdocs/adr/ADR-[4-digits]-[title].mdadr-template.md
UI Specdocs/ui-spec/[feature-name]-ui-spec.mdui-spec-template.md
UI Specアセットdocs/ui-spec/assets/{feature-name}/プロトタイプコードファイル-
Design Docdocs/design/[feature-name]-design.mddesign-template.md
作業計画書docs/plans/YYYYMMDD-{type}-{description}.mdplan-template.md
タスクファイルdocs/plans/tasks/{plan-name}-task-{NN}.md(backendのみの計画)、{plan-name}-backend-task-{NN}.md(frontendを含む計画のbackend)、{plan-name}-frontend-task-{NN}.md(frontend)task-template.md

生成パスの可変部分は、小文字ASCIIのkebab-case slugとする。非ASCIIの入力はパス作成前にこの形式へ変換する。

作業計画書は.gitignoreで除外される。

参照資料

各テンプレートが、そのドキュメントの内容、ステータス規則、必要なエビデンス、任意の図、完了条件を定める。作成またはレビューするドキュメントのテンプレートだけを読み込む。

© shinpr, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in .claude/skills-ja/documentation-criteria of shinpr/ai-coding-project-boilerplate.

  • SKILL.md
  • references/adr-template.md
  • references/design-template.md
  • references/plan-template.md
  • references/prd-template.md
  • references/task-template.md
  • references/ui-spec-template.md

Open the folder on GitHubat commit 56913a2

Compare with similar skills

Documentation Criteria next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Documentation Criteria compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Documentation Criteria this skillshinpr/ai-coding-project-boilerplate233—~865Automated safety check: PassMIT
Cabloy Spec Generationcabloy/cabloy982—~3.2kAutomated safety check: NotesMIT
Bmad Architectureaj-geddes/claude-code-bmad-skills488—~1.9kAutomated safety check: NotesCustom licence
Vibe CodingOfficeDev/microsoft-365-agents-toolkit781—~5.5kAutomated safety check: PassCustom licence
Documentation Criteriashinpr/claude-code-workflows693—~1.9kAutomated safety check: PassMIT
Ad ReviewCorridorTech/PoseCap224—~2.4kAutomated safety check: NotesApache-2.0

Similar skills

  • A skill your agent uses to create or maintain Cabloy suite specifications under repo-specs, including PRD, SRS, PDP/WBS, acceptance planning, progress, and suite ADRs.

    982 GitHub stars~3.2k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Bmad Architecture

    aj-geddes/claude-code-bmad-skills

    Solutioning skill (Winston, the Architect). An agent skill from aj-geddes/claude-code-bmad-skills.

    488 GitHub stars~1.9k tokensUpdated 3 mo ago
    DevelopmentAuto-check: notes
  • Vibe Coding

    OfficeDev/microsoft-365-agents-toolkit

    End-to-end workflow for agent-driven changes that add or modify behavior in the toolkit packages.

    781 GitHub stars~5.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Documentation Criteria

    shinpr/claude-code-workflows

    Determines which of PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires, and where each is stored.

    693 GitHub stars~1.9k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Ad Review

    CorridorTech/PoseCap

    Two-axis fresh-context code review per WORKFLOW §10. An agent skill from CorridorTech/PoseCap.

    224 GitHub stars~2.4k tokensUpdated 2 days ago
    DevelopmentAuto-check: notes
  • Squid Plan

    iusztinpaul/squid

    Turn a raw feature spec into an approved Tasks Plan — grill the spec, have the Product Architect groom draft tasks (+ optional ADR and glossary additions), then run ONE human gate that decides…

    203 GitHub stars~2.6k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

More from shinpr/ai-coding-project-boilerplate

All 41 skills in this repo
  • Integration E2E Testing

    shinpr/ai-coding-project-boilerplate

    Selects and designs the smallest integration/E2E test set that proves accepted behavior at an observable boundary.

    233 GitHub stars~2.8k tokensUpdated 6 days ago
    Auto-check passed
  • Skill Optimization

    shinpr/ai-coding-project-boilerplate

    Evaluates and optimizes skill file quality using 9 content patterns and 10 editing principles.

    233 GitHub stars~3.5k tokensUpdated 6 days ago
    Auto-check passed
  • Frontend Technical Spec

    shinpr/ai-coding-project-boilerplate

    Defines React environment, component architecture, state/data flow, build verification, and frontend non-functional criteria from repository evidence.

    233 GitHub stars~1.9k tokensUpdated 6 days ago
    Auto-check: notes
  • Frontend Typescript Rules

    shinpr/ai-coding-project-boilerplate

    Applies React/TypeScript type safety, component design, and state management rules.

    233 GitHub stars~1.7k tokensUpdated 6 days ago
    Auto-check passed
  • Implementation Approach

    shinpr/ai-coding-project-boilerplate

    Selects implementation strategy (vertical slice, horizontal, or hybrid) with risk assessment.

    233 GitHub stars~3.2k tokensUpdated 6 days ago
    Auto-check passed
  • Subagents Orchestration Guide

    shinpr/ai-coding-project-boilerplate

    Coordinates subagents through scale-based planning, approval, implementation, verification, and escalation flows.

    233 GitHub stars~8k tokensUpdated 6 days ago
    Auto-check passed

Questions about Documentation Criteria

What does Documentation Criteria do?

変更に必要なPRD、ADR、UI Spec、Design Doc、作業計画書と、それぞれの保存先を判定する。ドキュメントの範囲を決める時、または技術ドキュメントを作成・レビューする時に使用。. Documentation Criteria is an agent skill from shinpr/ai-coding-project-boilerplate.

When should I use Documentation Criteria?

Documentation Criteria fits situations like: tasks that involve Architecture decision records; tasks that involve PRD writing.

How do I install Documentation Criteria in Claude Code?

Run `npx skills add shinpr/ai-coding-project-boilerplate --skill documentation-criteria -a claude-code`. Or copy the skill folder (.claude/skills-ja/documentation-criteria in shinpr/ai-coding-project-boilerplate) into .claude/skills/documentation-criteria in your project. Claude Code loads it when a task matches its description.

How do I install Documentation Criteria in Codex?

Run `npx skills add shinpr/ai-coding-project-boilerplate --skill documentation-criteria -a codex`. Or copy the skill folder (.claude/skills-ja/documentation-criteria in shinpr/ai-coding-project-boilerplate) into .agents/skills/documentation-criteria in your project. Codex loads it when a task matches its description.

Can I use Documentation Criteria in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shinpr/ai-coding-project-boilerplate --skill documentation-criteria -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/documentation-criteria, .gemini/skills/documentation-criteria, .github/skills/documentation-criteria and .opencode/skills/documentation-criteria in your project.

What does Documentation Criteria need to run?

SKILL.md names no scripts, command-line tools or credentials: Documentation Criteria is instructions for the agent only.

Does Documentation Criteria access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Documentation Criteria safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Documentation Criteria use?

Documentation Criteria is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Documentation Criteria use?

About 865 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to Documentation Criteria?

Skills that share tags, products or a category with Documentation Criteria: Cabloy Spec Generation (cabloy/cabloy, 982 stars), Bmad Architecture (aj-geddes/claude-code-bmad-skills, 488 stars), Vibe Coding (OfficeDev/microsoft-365-agents-toolkit, 781 stars) and Documentation Criteria (shinpr/claude-code-workflows, 693 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Documentation Criteria?

shinpr (a GitHub user) maintains it in shinpr/ai-coding-project-boilerplate, which has 233 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 4, 2026.

Source: shinpr/ai-coding-project-boilerplate on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.