メニュー
Defines the required SKILL.md front-matter keys, size budget, index entry, and validation command for a new skill in this repository. Use when adding a new docs/skills directory or repairing front matter that fails validation.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/projectbluefin/bluefin --skill write-a-skillコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Explains workflow triggers, path filters, reusable workflow calls, and how to read failing runs in this repository. Use when a workflow failed, did not start, or ran the wrong checks.
States the package-source trust boundaries, signing requirements, and secure-boot constraints for this image. Use when adding a package source or changing verification or trust behavior.
Covers the release and testing-to-main promotion workflows, digest and tag verification, and signing gates. Use when running a release or diagnosing a failed promotion.
SOC 職業分類に基づく
SKILL.md を表示中
| name | write-a-skill |
| version | 1.0 |
| last_updated | 2026-08-06T00:00:00.000Z |
| id | write-a-skill |
| one_line_purpose | Author a new skill directory that satisfies this repository's front-matter contract. |
| entry_point | docs/skills/write-a-skill/SKILL.md |
| category | meta |
| mcp_compliance_level | partial |
| optimization_status | draft |
| status | active |
| dependencies | ["skill-improvement"] |
| tags | ["skills","authoring","documentation","front-matter","validation"] |
| description | Defines the required SKILL.md front-matter keys, size budget, index entry, and validation command for a new skill in this repository. Use when adding a new docs/skills directory or repairing front matter that fails validation. |
| metadata | {"type":"procedure","source-of-truth":[".github/scripts/validate-docs.py","docs/skills/index.md","AGENTS.md"]} |
docs/skills/<name>/SKILL.md.validate-docs.py rejects.Every docs/skills/<name>/SKILL.md starts with exactly these keys:
---
name: <kebab-case-name> # must equal the directory name
version: "1.0" # quoted semver string
last_updated: YYYY-MM-DD
id: <kebab-case-name> # must equal name and the directory name
one_line_purpose: <=120 chars, imperative, no "Use when" clause
entry_point: docs/skills/<name>/SKILL.md
category: ci-ops | test-authoring | meta
mcp_compliance_level: partial
optimization_status: draft
status: active | deprecated | reserved
dependencies: [] # ids of skills that must load first
tags: [tag1, , ]
metadata.source-of-truth is load-bearing: it tells an agent which files to
read before documenting mutable behavior. Never drop it when editing front
matter. metadata accepts additional keys (audience, context7-sources).
docs/skills/<name>/SKILL.md with the front matter above.one_line_purpose and description must describe this
skill specifically; templated filler is a defect.index.md linking <name>/SKILL.md.docs/skills/<name>/references/*.md and link it.## Use when — concrete triggers.## Do not use when — pointers to the neighbouring skills.## Procedure or ## Decision tree — the agent workflow.## Verify — commands that re-derive project-internal facts.This repository intentionally diverges from projectbluefin/common:
docs/skills/<name>/SKILL.md. Flat docs/skills/<name>.md files are not
recognized by validate-docs.py and will fail the missing-SKILL.md check.SKILL.md, enforced by validate-docs.py, rather
than common's 200-line soft / 500-line hard budget. AGENTS.md is capped at
150 lines and docs/skills/index.md at 80.index.json, index.schema.json, or generate_skill_index.py. The catalog
is small enough to curate by hand; validate-docs.py fails if a skill is
missing from index.md.validate-docs.py parses front matter with
a small hand-rolled reader, so the validate CI job needs no extra
packages. Keep new front-matter constructs simple: top-level scalars, inline
[a, b] lists, folded >- blocks, and one nested metadata mapping.id, name, or entry_point disagreeing with the directory name.description over 256 characters or missing its Use when sentence.index.md.source-of-truth file already owns.python3 .github/scripts/validate-docs.py
wc -l docs/skills/*/SKILL.md
pre-commit run --all-files