CtrlK
BlogDocsLog inGet started
Tessl Logo

makefile-validator

Comprehensive toolkit for validating, linting, and optimizing Makefiles. Use when working with Makefiles (Makefile, makefile, *.mk files), validating build configurations, checking for best practices, identifying security issues, or debugging Makefile problems. Concrete capabilities include detecting missing .PHONY declarations, validating tab indentation in recipes, checking variable expansion safety, identifying hardcoded credentials, and flagging missing prerequisites or syntax errors.

73

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and workflows are clearly sequenced with re-validation feedback loops, and the bundle structure supports clean one-level-deep progressive disclosure. The main weakness is token efficiency: the verbatim example output, duplicate directory/reference listings, repeated scenario commands, and inline anti-pattern explanations that duplicate references/common-mistakes.md could be trimmed without losing any utility.

Suggestions

Cut or shorten the ~30-line Example Output block to a few representative lines and drop the Directory Structure tree (the References section already lists the same files) to reduce token cost.

Delete Scenario 1: Pre-commit Validation, which repeats the identical Quick Start command verbatim, and fold it into the Integration section it duplicates.

Compress the Anti-Patterns WHY explanations (tab indentation, .PHONY mechanics) into one-line reasons with a pointer to references/common-mistakes.md, which already contains the detailed explanations and fixes.

DimensionReasoningScore

Conciseness

The body is mostly efficient but has clear slack: a ~30-line verbatim "Example Output" block, a 14-line "Directory Structure" tree that duplicates the References section, "Scenario 1: Pre-commit Validation" repeating the identical Quick Start command, and Anti-Patterns "WHY" explanations (e.g. why GNU Make requires tabs, why .PHONY matters) that largely duplicate references/common-mistakes.md and cover concepts an experienced agent already knows. This fits the 3 anchor ("mostly efficient but includes some unnecessary explanation or could be tightened") better than 4, where over-explanation would be only minor.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready: "bash scripts/validate_makefile.sh Makefile", "mbake format --diff Makefile", "go install github.com/checkmake/checkmake/cmd/checkmake@latest", plus documented exit codes (0/1/2). Concrete scenarios cover the common cases (pre-commit, formatting, legacy conversion, security audit), matching the 5 anchor; the 4 anchor's "minor gaps" standard is exceeded.

5 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced with validation checkpoints and feedback loops: Scenario 3 runs "1. Validate current state ... 4. Re-validate", and Scenario 2 previews ("mbake format --diff"), applies, then re-validates; the base workflow's exit codes (0/1/2) give an explicit pass/warn/fail checkpoint. This matches the 5 anchor (explicit validation steps and re-validation loops) rather than 4, which allows minor validation gaps that are not present.

5 / 5

Progressive Disclosure

Good structure against the actual bundle: all referenced paths are real files, references are one level deep and well signaled both inline ("See references/best-practices.md ...") and in a dedicated References section with per-file descriptions. It falls short of 5 on minor organization gaps: the Directory Structure tree duplicates the reference listing, and the assets/good-makefile.mk and bad-makefile.mk examples are named in the tree but never linked as instructional pointers in the body.

4 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states a clear capability set with concrete checks, includes an explicit 'Use when...' clause with natural trigger terms covering file-name synonyms and extensions, and occupies a distinct niche. Only nitpick is the mild buzzword opener "Comprehensive toolkit", which costs nothing given the concrete list that follows.

DimensionReasoningScore

Specificity

The description lists multiple concrete, specific actions: "detecting missing .PHONY declarations, validating tab indentation in recipes, checking variable expansion safety, identifying hardcoded credentials, and flagging missing prerequisites or syntax errors" — comprehensive coverage of the skill's capabilities. The only mild padding is the opener "Comprehensive toolkit", which does not dilute the concrete capability list that follows, so it stays at 5 rather than dropping to 4.

5 / 5

Completeness

It explicitly answers both questions: the "what" ("validating, linting, and optimizing Makefiles" plus the enumerated concrete capabilities) and the "when" ("Use when working with Makefiles (Makefile, makefile, *.mk files), validating build configurations, ... or debugging Makefile problems"). This mirrors the 5-anchor example structure almost exactly; the 4 anchor's "'when' could be more explicit" does not apply here.

5 / 5

Trigger Term Quality

Natural user phrasing is covered including synonyms and file extensions: "Makefiles (Makefile, makefile, *.mk files)", "validating build configurations", "checking for best practices", "debugging Makefile problems". This matches the top anchor ("comprehensive coverage of natural terms including synonyms and file extensions") better than the 4 anchor, which expects a few natural terms missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche (Makefile validation/linting/optimization) with distinct triggers (specific file names and validation activities); minimal conflict risk with other skills. It is not below 5 because the trigger terms are narrowly scoped to Makefile artifacts rather than generic build or code-review language.

5 / 5

Total

20

/

20

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pantheon-org/tekhne
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.