pantheon-ai/makefile-validator
Comprehensive toolkit for validating, linting, and optimizing Makefiles. Use this skill when working with Makefiles (Makefile, makefile, *.mk files), validating build configurations, checking for best practices, identifying security issues, or debugging Makefile problems.
Overall
score
100%
Does it follow best practices?
Validation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the marks. It provides specific concrete capabilities, includes a clear 'Use when...' clause with natural trigger terms, and is highly distinctive to Makefile-related tasks. The description uses proper third-person voice throughout and balances comprehensiveness with clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'detecting missing .PHONY declarations, validating tab indentation in recipes, checking variable expansion safety, identifying hardcoded credentials, and flagging missing prerequisites or syntax errors.' | 3 / 3 |
Completeness | Clearly answers both what ('validating, linting, and optimizing Makefiles' plus specific capabilities) AND when ('Use when working with Makefiles... validating build configurations, checking for best practices, identifying security issues, or debugging Makefile problems'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Makefiles', 'Makefile', 'makefile', '*.mk files', 'build configurations', 'best practices', 'security issues', 'debugging Makefile problems', '.PHONY', 'tab indentation', 'recipes'. | 3 / 3 |
Distinctiveness Conflict Risk | Very clear niche focused specifically on Makefiles with distinct triggers like '.PHONY declarations', 'tab indentation in recipes', '*.mk files' - unlikely to conflict with general code linting or other build system skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exemplary skill file that demonstrates excellent token efficiency while providing comprehensive, actionable guidance. The content is well-structured with clear workflows, explicit validation steps, and appropriate progressive disclosure to reference materials. The example output and exit code documentation make integration straightforward.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, avoiding explanations of what Makefiles are or how make works. Every section provides actionable information without padding, and bullet points are used effectively to convey capabilities quickly. | 3 / 3 |
Actionability | Provides fully executable bash commands, concrete example output showing exactly what to expect, clear exit codes, and step-by-step scenarios with copy-paste ready commands. The validation script path and usage are explicit. | 3 / 3 |
Workflow Clarity | Multi-step processes like 'Converting Legacy Makefiles' have clear numbered sequences with validation checkpoints (validate -> fix -> format -> re-validate). Exit codes are explicitly mapped to pass/warn/fail states for automation integration. | 3 / 3 |
Progressive Disclosure | Excellent structure with quick start at top, scenarios for common use cases, and clear one-level-deep references to detailed docs (best-practices.md, common-mistakes.md, bake-tool.md). Directory structure helps navigation. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Install with Tessl CLI
npx tessl i pantheon-ai/makefile-validatorReviewed
Table of Contents