out-of-tree-setup

Scaffold an out-of-tree LLVM 22 compiler/language project from scratch. Covers CMake configuration, finding LLVM, linking components, a minimal LLVMContext driver, and build instructions.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tiles/tessl-llvm/skills/out-of-tree-setup/SKILL.md

Quality

Content

85%Scale 1-3

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

This is a strong, well-structured skill that provides fully executable scaffolding for an out-of-tree LLVM 22 project. The step-by-step workflow is clear with good validation (verifyModule), concrete code examples, and a useful 'common mistakes' section. Minor conciseness improvements could be made by trimming inline component descriptions and some explanatory comments that Claude doesn't need.

Suggestions

Remove the inline comments explaining what each LLVM component provides (Core, Support, Analysis, etc.) — Claude already knows these; a simple list suffices.

Dimension	Reasoning	Score
Conciseness	Generally efficient but includes some unnecessary commentary (e.g., inline comments explaining what Core, Support, Analysis do — Claude knows LLVM components). The component list comments and some explanatory notes could be trimmed. However, it avoids explaining what LLVM is or basic C++ concepts.	2 / 3
Actionability	Fully executable CMakeLists.txt, complete compilable main.cpp, exact bash commands for building. The code is copy-paste ready with clear placeholder markers (<ProjectName>). The optimization pipeline snippet and pass plugin CMake are also concrete and executable.	3 / 3
Workflow Clarity	Clear numbered steps from prerequisites through build and optional extensions. Includes explicit validation via verifyModule() with error handling, and the build step has a clear configure→build→run sequence. The 'common mistakes to avoid' section serves as a validation checklist.	3 / 3
Progressive Disclosure	Well-structured progression from prerequisites to minimal setup to optional extensions (optimization pipeline, pass plugin). Steps 5-6 are clearly marked optional. References the 'add-npm-pass' skill for further detail without deep nesting. Content is appropriately scoped for a single SKILL.md.	3 / 3
	Total	11 / 12 Passed

Description

67%Scale 1-3

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

The description is strong in specificity and distinctiveness, clearly identifying a narrow technical niche with concrete deliverables. Its main weaknesses are the lack of an explicit 'Use when...' clause and incomplete coverage of natural trigger terms users might employ when seeking help with LLVM project setup.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to create a new LLVM-based compiler, language frontend, or tool project from scratch.'

Include additional natural trigger terms like 'new language', 'LLVM frontend', 'LLVM pass project', 'llvm-config', or 'LLVM boilerplate' to improve keyword coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: scaffold a project, CMake configuration, finding LLVM, linking components, creating a minimal LLVMContext driver, and build instructions.	3 / 3
Completeness	Clearly answers 'what does this do' (scaffold an out-of-tree LLVM project with specific components), but lacks an explicit 'Use when...' clause or equivalent trigger guidance, which caps this at 2 per the rubric.	2 / 3
Trigger Term Quality	Includes relevant terms like 'LLVM 22', 'CMake', 'out-of-tree', 'compiler', 'language project', but misses common user phrasings like 'LLVM pass', 'LLVM frontend', 'new language', 'llvm-config', or variations users might naturally say when starting an LLVM project.	2 / 3
Distinctiveness Conflict Risk	Very specific niche: out-of-tree LLVM 22 project scaffolding with CMake. This is unlikely to conflict with other skills due to the highly specialized domain and version-specific targeting.	3 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

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.

Repository: hbarve1/tessl-llvm
Path: tiles/tessl-llvm/skills/out-of-tree-setup/SKILL.md
Commit: a251bde

Reviewed: 6 days ago

Table of Contents

Discovery Implementation Validation

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.