skills

個人用の agent skills 集。Claude Code をはじめ、SKILL.md 形式に対応した各種エージェントで使える。

スキル一覧

スキル	説明
blog-ops	Hugo ブログ(PaperMod テーマ想定)の運用と執筆フロー全体の入口となるスキル。企画・執筆スキルへの振り分け、新規記事のセットアップ、公開前チェック、タグ管理、作業規約をまとめる。ブログリポジトリで記事やタグ・設定に触れる作業はここから始める。
blog-idea-grilling	記事アイデアを企画に育て、次工程で使う企画カードにまとめるスキル。素材・読者・主張がまだ曖昧な企画段階で使う。
blog-writing-guide-ja	日本語技術ブログの企画・構成・品質基準・レビューのガイド。読者の疑問に沿った記事構成、タイトルと見出しの付け方、SEO、公開前レビューの観点を定める。文レベルの文体は writing-ja の担当なので、記事を書くときは併用する。
writing-ja	日本語の技術記事、ブログ記事、解説文の本文を執筆・推敲するスキル。事実関係と書き手の声を保ちながら、論理、具体性、文の読みやすさを整える。
fact-check-ja	記事に書く事実を一次情報で裏取りするスキル。数値、バージョン依存の挙動、比較、断定、時間で変わる記述を確認し、確認できなかった主張は範囲を狭めて書き直す。
agent-orchestration	Herdr セッション上で、現在のエージェントがオーケストレーションとレビューを担い、Pi explorer に調査、Pi fixer に実装を委譲するスキル。委譲が不確実性・実装リスク・レビューリスクを十分に下げる場合に使う。HERDR_ENV=1 が必要で、herdr スキルと併用する。
continuous-improvement-loop	リポジトリを反復的に改善する自律ループのスキル。各ラウンドで現状を再評価して価値のある改善を一つだけ選び、必要に応じて agent-orchestration を使い、レビュー・検証・コミット後に次のラウンドの妥当性を判断する。固定のタスクリストではなく、改善余地がなくなるまでの継続的な改善に使う。

インストール

skills CLI でインストールする。

npx skills@latest add j1nn0/skills

特定のスキルだけ入れる場合は -s で指定する。

npx skills@latest add j1nn0/skills -s writing-ja

プロジェクト単位ではなくユーザー全体で使う場合は -g を付ける。

npx skills@latest add j1nn0/skills -g

開発

検証

外部依存なしで、スキルの front matter と同梱スクリプトを検証できる。

python3 -m unittest discover -s tests

GitHub Actions でも同じテストを実行する。ブログリポジトリに適用する blog-ops の記事検査は、スキルディレクトリ内の scripts/check_posts.py を実行する。タグ数とタグ表記の既定は、対象リポジトリの規約に合わせて CLI オプションで変更できる。

description の評価

evals/trigger/ には、評価対象にしたスキルの description を評価するための should-trigger / should-not-trigger のテストセットを置く。現在の対象は writing-ja、blog-writing-guide-ja、blog-ops、blog-idea-grilling、fact-check-ja である。description を変更する前に内容をレビューし、skill-creator または Codex の評価器で検証する。

Codex で評価する場合は、evals/trigger/run_codex_eval.py を使う。gpt-5.6-luna と low reasoning で、description とユーザー要求だけからスキルを参照すべきかを判定する。これは Claude の発火率とは別の Codex 向け指標である。結果は evals/trigger/results/ に保存され、Git では追跡しない。

License

Original repository content is licensed under the MIT License unless a skill directory specifies a different license. This includes blog-ops, fact-check-ja, agent-orchestration, and continuous-improvement-loop.

Some skills are derived from third-party works and are subject to their own license and attribution requirements. See the LICENSE, SOURCES.md, and, where present, NOTICE files in each skill directory for the applicable terms.