CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

61

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/dj-set-architect/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 nine-step workflow, a user review/refine loop, and good safety guardrails. The main weakness is actionability: the actual sequencing rules (Camelot compatibility, BPM/energy thresholds) and export formats are named but never specified.

Suggestions

State the concrete Camelot Wheel compatibility rules (e.g., same number ±1, adjacent letters) and acceptable BPM-change ranges so step 4 is executable without external lookups.

Add a short example of the set plan output structure and the M3U export format to make steps 5 and 7 copy-paste ready.

Add a verification step after export (e.g., confirm all playlist tracks exist in the library before pushing to subsonic) to lift workflow clarity to 5.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no concept explanations, terse one-line workflow steps — but integration information is repeated across "Workflow Steps" (steps 7–9), the "MCP" section ("uses `subsonic-mcp` for playlist output; Obsidian MCP for note creation"), and the "Companion Skills" section. That duplication is a minor trim candidate, fitting anchor 4 ('efficient; minor instances that could be trimmed') rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Some concrete guidance exists — named sources and targets ("`dj-library-curator` crates", "`subsonic-mcp`", "`obsidian-music-journal`", "`homelab-logbook`") and example invocations — but the core task stays high-level: "Apply harmonic mixing rules (Camelot Wheel); build BPM flow curve respecting energy shape" without stating which Camelot transitions are compatible, what BPM-change limits to respect, what an energy value means, or the M3U output format. This is 'some concrete guidance but incomplete; missing key details' (3), not the mostly-executable anchor 4.

3 / 5

Workflow Clarity

Nine steps are clearly and logically ordered with a user feedback loop (step 5 "Review: Present draft tracklist..." → step 6 "Refine: Accept user edits") and destructive-operation protection in Safety ("Always confirm before overwriting an existing set plan"). Minor gap: no post-export verification, keeping it at anchor 4 rather than anchor 5's explicit validate-and-retry checkpoints.

4 / 5

Progressive Disclosure

The skill is under 50 lines with well-organized sections (Purpose, Invocation, Workflow Steps, Safety, MCP, References, Companion Skills) and clearly labeled one-level-deep external URL references. The references/ and scripts/ bundle directories are empty (only .gitkeep), so nothing needs splitting; per the simple-skill scoring note this earns a 5 on section organization alone.

5 / 5

Total

16

/

20

Passed

Description

71%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, specific, third-person description that clearly conveys what the skill does with concrete domain actions. Its main weakness is the complete absence of a 'when to use' trigger clause, which caps completeness at 3.

Suggestions

Add an explicit trigger clause such as 'Use when the user asks to plan, sequence, or build a DJ set, mix, or tracklist' to lift completeness above 3.

Include natural synonyms and format terms (mix, mixtape, playlist, M3U) to broaden trigger term coverage toward 5.

Mention export targets (DJ software formats, M3U, Obsidian) in the description to close the minor specificity gap and sharpen distinctiveness from library-curation skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "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" — covering the domain comprehensively rather than vaguely. This matches the anchor 'lists multiple specific concrete actions; comprehensive coverage' and exceeds anchor 4, whose hallmark is a noticeable coverage gap.

5 / 5

Completeness

The 'what' is clearly and concretely stated, but there is no "Use when..." clause or any equivalent explicit trigger guidance, capping this dimension at 3 per the judging guidelines. It is above anchor 2 (which requires a vague or missing 'what') but fails anchor 4's requirement that both what and when be present.

3 / 5

Trigger Term Quality

Natural phrases users would say are present — "DJ sets", "harmonic mixing", "BPM", "tracklists", "set plans" — but common synonyms and format terms like "mix", "mixtape", "playlist", and "M3U" are absent. This fits 'good keyword coverage; a few natural terms missing' (4) rather than the comprehensive synonym/extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The DJ set-sequencing niche with harmonic mixing, BPM flow, and energy curves is mostly distinct from generic music skills, but "generate set plans and tracklists from the curated DJ library" carries minor overlap risk with the closely related library-curation/playlist skills. It fits 'mostly distinct; minor overlap risk with closely related skills' better than anchor 5's minimal-conflict bar.

4 / 5

Total

16

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pvnkmnk/AgenticSelfHostSkills
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.