dj-set-architect

Design and sequence DJ sets using harmonic mixing principles, BPM flow analysis, and energy curve planning; generate set plans and tracklists from the curated DJ library.

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 ./skills/dj-set-architect/SKILL.md

Quality

Content

78%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.

A concise, well-structured skill body with a clear sequenced workflow and appropriate safety checks, held back mainly by actionability — it points at concepts and companion skills rather than embedding the concrete harmonic-mixing rules and BPM-flow constraints needed to execute. Adding the actual rules would raise the score.

Suggestions

Embed the Camelot Wheel key-compatibility rules (e.g. same key, ±1 on the wheel, relative major/minor) directly in the Sequence step so execution does not require an external lookup.

Add concrete BPM-flow guidance (e.g. typical ±3 BPM per transition, energy-curve ramp targets) instead of only naming 'BPM flow analysis' and 'energy curve planning'.

Specify the exact delegation call format to dj-library-curator (parameter names / crate query shape) so the Query step is reproducible.

Dimension	Reasoning	Score
Conciseness	Lean and efficient ~43-line body with no padding or explanation of concepts Claude already knows (it does not define Camelot Wheel, BPM, or energy curves); every section earns its place.	5 / 5
Actionability	The 9 steps give a clear procedural shape but stop at references like 'Apply harmonic mixing rules (Camelot Wheel)' without embedding the actual rules or concrete BPM-flow constraints, leaving key execution details missing.	3 / 5
Workflow Clarity	A clearly sequenced 9-step process with checkpoints (filter unanalyzed tracks, review draft, refine with user) and safety confirmations before overwriting set plans; minor validation gaps keep it just below a 5.	4 / 5
Progressive Disclosure	Well under 50 lines with cleanly organized sections and one-level-deep external references (Camelot Wheel, Mixed In Key, bpm-tools URLs) plus a Companion Skills list; no bundle files are needed, satisfying the simple-skill exception.	5 / 5
	Total	17 / 20 Passed

Description

75%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 specific, well-scoped description with strong capability coverage and a distinct niche, weakened by the total absence of an explicit 'when to use' trigger clause. Adding a Use-when phrase would lift completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user wants to plan or sequence a DJ set, build a tracklist, or design a BPM/energy arc from the curated library.'

Include the output format term a user would naturally name (e.g. M3U playlist) to improve trigger-term coverage.

Mirror the natural phrasing users say ('DJ set', 'setlist', 'playlist', 'warm-up/peak set') as explicit trigger keywords.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions and techniques — 'Design and sequence DJ sets', 'harmonic mixing principles, BPM flow analysis, and energy curve planning', 'generate set plans and tracklists' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the rubric caps completeness at 3.	3 / 5
Trigger Term Quality	Natural domain terms like 'DJ sets', 'set plans', 'tracklists', 'harmonic mixing', and 'BPM' are present, but some common synonyms and file formats a user might mention (e.g. M3U, playlist) are missing.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (DJ set sequencing via harmonic/BPM/energy analysis) distinct from the companion library-curation skill, with minimal risk of triggering for the wrong skill.	5 / 5
	Total	17 / 20 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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: pvnkmnk/AgenticSelfHostSkills
Path: skills/dj-set-architect/SKILL.md
Commit: 0f62e6b

Reviewed: 4 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.