File contents
name: skill-name
description: いつこの Skill を使うか・何をするかを一文で。name と description だけは常時ロードされ(progressive disclosure)、Claude はこれを読んで発動可否を判断する。だから「どんな状況・どんな指示で使うか」のトリガーを具体的に書く。例) "PR を作成するとき。「PR 作って」等で発動。ブランチを切り、Conventional Commits タイトルとテンプレ本文で PR を作成する。"
<Skill のタイトル>
このスキルがやること
<何を達成するスキルか、1〜2 行で>
手順
<ステップ 1>
<ステップ 2>
<ステップ 3>
ルール・コツ
<守ってほしい制約>
<ありがちな失敗とその回避>
<他の Skill / Rules / Hook と連携するなら、その関係>
完了条件
以下を全て満たしたら完了。満たせない項目があれば、黙って省略せず理由を報告する。
補足
社内固有情報(社名・内部 URL・認証情報など)は書かない。環境差は引数や環境変数で受け取る。
「毎回必ず実行/ブロックしたい」処理が出てきたら、それは Skill ではなく Hook に切り出す。
1 --- 2 name: templates 3 description: <!-- 4 --- 5 <!-- 6 作る前に: これは本当に「Skill」向きか?(→ ../README.md「Skill と他の操縦手段」) 7 - 呼び出して使う手順(procedure) → Skill(このテンプレ) 8 - 常に守る制約(〜してはいけない / 〜であること)→ Rules(.claude/rules/。paths でスコープ可) 9 - モデルの判断を介さず確実に走らせる/止める → Hook(.claude/settings.json の PreToolUse 等) 10 - 別コンテキストで調査して結果だけ返したい → Subagent(.claude/agents/) 11 Skill だと確定したら、この説明コメントごと中身を書き換える。 12 --> 13 --- 14 name: skill-name 15 description: いつこの Skill を使うか・何をするかを一文で。name と description だけは常時ロードされ(progressive disclosure)、Claude はこれを読んで発動可否を判断する。だから「どんな状況・どんな指示で使うか」のトリガーを具体的に書く。例) "PR を作成するとき。「PR 作って」等で発動。ブランチを切り、Conventional Commits タイトルとテンプレ本文で PR を作成する。" 16 --- 17 18 # <Skill のタイトル> 19 20 ## このスキルがやること 21 22 <何を達成するスキルか、1〜2 行で> 23 24 ## 手順 25 26 1. <ステップ 1> 27 2. <ステップ 2> 28 3. <ステップ 3> 29 30 ## ルール・コツ 31 32 - <守ってほしい制約> 33 - <ありがちな失敗とその回避> 34 - <他の Skill / Rules / Hook と連携するなら、その関係> 35 36 ## 完了条件 37 38 以下を全て満たしたら完了。**満たせない項目があれば、黙って省略せず理由を報告する。** 39 40 - [ ] <検証可能な条件 1(実行結果・成果物で確認できること)> 41 - [ ] <検証可能な条件 2> 42 - [ ] <検証可能な条件 3> 43 44 ## 補足 45 46 - 社内固有情報(社名・内部 URL・認証情報など)は書かない。環境差は引数や環境変数で受け取る。 47 - 「毎回必ず実行/ブロックしたい」処理が出てきたら、それは Skill ではなく Hook に切り出す。 48 49 <!-- 50 書き方のコツ(どのモデルでも品質を安定させる): 51 - 完了条件は「〜を確認した」「〜が通る」など検証可能な形で書く。「適切に」「十分に」等の曖昧語は避ける。 52 - 本文に載せる確認系コマンド(読み取り・`--check`・`--dry-run` 等)は一度実行して確かめてから書く。適用系(設定変更・書き込み)は `--help` や公式ドキュメントで構文を確認する(skill-lint の項目 10 が検証する)。 53 - 手順は目標と制約を示す粒度に留め、過度にステップを細分化しない(細かすぎる指示はかえって品質を下げる)。モデルが既に知っている操作(VCS の基本コマンド等)を手順書にしない。正確なコマンドを載せるのは、間違えると壊れる操作(設定変更・リリース・削除)に限る。 54 - 制約には理由を添える(「〜しない。理由: …」)。理由が分かるとモデルは想定外の場面にも正しく汎化する。強調語(必ず・絶対・太字)は本当に譲れない 1〜2 の制約に限り、全体を強調で塗らない。 55 - 「旧 ◯◯」「今は〜に変わった」等の移行相対表現や、過去の経緯の語りは書かない(現行ルールだけを書く)。 56 - 判断が分かれる場面には if/then の判断基準を書く(例: 軽微→その場で修正 / 大きい→Issue化)。 57 - 報告・成果物に決まった形があるなら「出力フォーマット」を表テンプレで示す(モデル間の出力ブレを直接抑える)。 58 - 曖昧になりがちな規約(命名・タイトル書式等)は、良い例/悪い例の対比表で固定する。 59 - 不明・判定不能なケースの扱い(推測せず確認する / 「不明」と明記する)を書いておく。 60 --> 61
turntuptechnologies-ai/skills/tree/main/templates commit 54fa744916
Frequently asked questions How do I install the Templates skill? Run npx skillmds@latest add turntuptechnologies-ai/templates in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Templates skill do? <!-- It is listed under Coding & Dev Tools on SkillMD.
Is Templates safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Templates? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Templates free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Templates? turntuptechnologies-ai (@turntuptechnologies-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.