CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

editing-cordis-compositions

Use when creating, changing, or validating a Cordis composition for this harness — writing or editing an agent preset, adding or removing a plugin row, deciding whether something belongs to the host composition or to one session, checking whether a preset you authored actually mounts, or diagnosing a row that mounted but contributed nothing.

Quality

92%

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

88%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 high-quality instructional body: concrete, executable, and validated end to end, with error-recovery guidance tied to real runtime messages. Its two soft spots are a handful of trimmable restatements and an all-inline structure that could offload reference material to bundle files.

Suggestions

Move the roster API signature list, the mount-validation error catalog, and the disabled subagent YAML templates into references/ files (e.g., references/api.md, references/errors.md) and link them one level deep, keeping SKILL.md a leaner overview.

Trim rule restatements such as the 'Reading a shipped composition is the intended way to start...' sentence in the Off-limits section, which repeats the section's own prohibition.

DimensionReasoningScore

Conciseness

The body is dense with harness-specific, non-inferable facts and assumes competence throughout, but a few passages restate rules or run discursive — e.g., 'Reading a shipped composition is the intended way to start; writing to one is not, and neither is editing the host composition to work around a preset limitation' repeats the section's own prohibition — leaving minor instances that could be trimmed.

4 / 5

Actionability

Fully executable guidance: a complete copy-paste JS plugin for mount-validation, exact API calls ('cordis_inspect what:"api" name:"agentPresets"', 'standingKeyFor(id)', 'copy(from, id, name?)'), ready-to-copy YAML templates for the subagent rows, and the literal error-message strings to expect — covering the common cases.

5 / 5

Workflow Clarity

The numbered authoring sequence (copy, expect sandbox, write metadata, edit rows, mount-validate) is explicitly capped by the 'standingKeyFor(id) is the check' validation step, with a four-failure-mode catalog and feedback loops ('read the rejection — it names the offending service') plus a post-validation handoff to a real session.

5 / 5

Progressive Disclosure

Well-ordered, clearly headed sections make the ~150-line single file easy to navigate with no nested references, but it is a monolith — the roster API details, the error-message catalog, and the disabled subagent templates are candidates for one-level-deep reference files that would keep SKILL.md a leaner overview.

4 / 5

Total

18

/

20

Passed

Description

92%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 that pairs an explicit 'Use when' trigger clause with a comprehensive, concrete enumeration of the skill's capabilities. Its only weakness is omitting a few natural file-level terms (e.g., 'cordis.yml') that a user might say.

DimensionReasoningScore

Specificity

The description enumerates six concrete actions — 'creating, changing, or validating a Cordis composition', 'writing or editing an agent preset', 'adding or removing a plugin row', 'deciding whether something belongs to the host composition or to one session', 'checking whether a preset you authored actually mounts', and 'diagnosing a row that mounted but contributed nothing' — comprehensively covering authoring, editing, validation, and diagnosis.

5 / 5

Completeness

It explicitly answers 'when' with a detailed 'Use when...' clause and 'what' through the enumerated concrete actions, matching the anchor for both halves with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural user phrasings like 'agent preset', 'plugin row', 'host composition', and 'a row that mounted but contributed nothing' are present with verb variations (create/change, write/edit, add/remove), but file-level terms a user might naturally mention such as 'cordis.yml' or 'preset.yml' are absent, leaving a few natural terms missing.

4 / 5

Distinctiveness Conflict Risk

'Cordis composition for this harness' carves out a clear niche with domain-specific triggers (presets, plugin rows, mount validation) that no generic skill would compete for, giving minimal conflict risk.

5 / 5

Total

19

/

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

river666/deepseek-harness-enterprise

Path

apps/cli/config/agent-presets/cordis/skills/editing-cordis-compositions/SKILL.md

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.