yohi/makefile-organization
agent-skills/makefile-organization/SKILL.md
Guidelines for organizing and maintaining modular Makefiles. Use when refactoring, creating new .mk files, or ensuring consistency across the project's Makefile structure. Covers naming conventions, inclusion order, idempotency management, and error handling for a robust development environment.
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add yohi/dots makefile-organizationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 5:29 PM12.3s2 files scanned
SKILL.md
- name:
- makefile-organization
- description:
- Guidelines for organizing and maintaining modular Makefiles. Use when refactoring, creating new .mk files, or ensuring consistency across the project's Makefile structure. Covers naming conventions, inclusion order, idempotency management, and error handling for a robust development environment.
Makefile Organization Rules
Context
このプロジェクトのMakefile分割・保守に関するルール
Instructions
<instructions>[!IMPORTANT] Makefile の詳細な分類、マクロ仕様、エラーハンドリング、テスト構造、および新機能追加時のチェックリストについては、REFERENCE.md を必ず参照してください。
1. Makefileの構造化
- 大きなMakefile（1000行以上）は機能別に分割する
- メインMakefileはincludeディレクティブと最小限のターゲットのみを含む
- 分割ファイルは
mk/ディレクトリに格納する
2. ファイル命名規則
- 分割ファイル名は機能を表す英語名.mkとする
- ファイル名は小文字のみを使用
- 複合語はハイフン1つで区切る（例:
sticky-keys.mk） - アンダースコアは使用しない
- 略語は避け、意味が明確な名前を使用する
3. include順序
メインMakefileでのinclude順序は以下の論理構造を遵守：
- Core:
variables.mk,idempotency.mk,help.mk,presets.mk - Infrastructure:
bitwarden.mk - Functional:
system.mk,fonts.mk,install.mk,setup.mk,gnome.mk, etc. - Meta:
main.mk,stages.mk,menu.mk,shortcuts.mk,deprecated-targets.mk - AI & Tools:
cursor.mk,claude.mk,gemini.mk,opencode.mk, etc. - Testing:
test.mk
4. コーディング規則とメッセージ
- アクション-対象の形式：
setup-vim,install-homebrew - 動詞から始める：
install-,setup-,clean-,backup-,check-,test- - 絵文字を使用したフレンドリーなエコーメッセージを使用：
🚀 セットアップを開始中...📦 パッケージをインストール中...✅ 完了⚠️ 警告❌ エラー
5. 冪等性管理
idempotency.mkのマクロを使用して、時間のかかる処理の二重実行を防ぐ：
@if $(call check_marker,target-name); then
echo "$(call IDEMPOTENCY_SKIP_MSG,target-name)";
exit 0;
fi
# ...
@$(call create_marker,target-name,1.0.0)
Guidelines
<instructions> - 新規ファイル追加時は `variables.mk` の PHONY リストを必ず更新すること。 - 1ファイルが200行を超えたら、更なる分割を検討すること。 </instructions>Related Skills
yohi/config-modernizer
development
VerifiedTrustedCommunity
OpenCodeの設定ファイルを分析し、最新のベストプラクティスやリリース情報に基づいてリファクタリングを行う専門スキル
SKILL.mdUpdated Apr 16, 2026
yohi/agent-skill-architect
development
VerifiedTrustedCommunity
Designs and generates best-practice-compliant SKILL.md files for OpenCode agent skills. Use when creating new agent skills, drafting skill definitions, or improving existing skill files. Guides through requirements discovery and outputs production-ready SKILL.md with proper YAML frontmatter, XML-structured instructions, and progressive disclosure patterns.
SKILL.mdUpdated Apr 16, 2026
yohi/dotfiles-guidelines
development
VerifiedTrustedCommunity
Core principles, persona definitions, and command workflows for the dotfiles project. Use when seeking development guidance, selecting an appropriate expert persona (Architect, Developer, Tester, DevOps, Analyst), or following standard project commands (analyze, implement, design, etc.). Ensures consistency, quality, and adherence to project-wide best practices.
SKILL.mdUpdated Apr 16, 2026
yohi/config-modernizer
development
VerifiedTrustedCommunity
OpenCodeの設定ファイルを分析し、最新のベストプラクティスやリリース情報に基づいてリファクタリングを行う専門スキル
SKILL.mdUpdated Apr 16, 2026