CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

treatment-plans

Formats and structurally validates local treatment-plan documentation after clinical decisions have already been supplied and verified by authorized licensed professionals. Use for source traceability, clinician-authored intervention records, goals and checkpoints, shared-decision records, reconciliation handoffs, and release gates—not for clinical decision-making.

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

92%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 an exemplary operations document: fully executable commands with working-directory context, an explicit validation-gated workflow with a correction feedback loop, precise input contracts, and a clean one-level reference structure that was verified against the actual bundle. The only weakness is mild redundancy in boundary restatements across sections and a boilerplate citation appendix, which cost it the top conciseness mark.

DimensionReasoningScore

Conciseness

The body is dense and operational — exact commands, file paths, date formats, and release-gate rules — with essentially no explanation of concepts Claude already knows, fitting 'efficient; minor instances of over-explanation that could be trimmed'. The trimmable material is the boundary restatement recurring across the safety-boundary, scripts, source-boundaries, and human-review sections, plus the 15-line boilerplate citation section; this repetition is more than a perfect-5 body would carry but is scoped differently each time, so it sits above level 3 rather than at it.

4 / 5

Actionability

Commands are copy-paste ready and complete: the generator invocation with arguments ('python3 scripts/generate_template.py --output-dir ./local-plan-package --subject-ref SYNTHETIC-CASE-001 --classification synthetic'), six validation script invocations, the timeline generator, the unittest discover command, and the AST-parse one-liner, each with its working-directory context stated. Exact input contracts (six named template files) and exact date/timestamp formats ('YYYY-MM-DD', 'YYYY-MM-DDTHH:MM:SS[.ffffff]Z') cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

The five-step workflow (establish authority → generate package → transcribe without inference → run deterministic checks → human review and release) is clearly sequenced with explicit validation checkpoints: the release gate is held 'blocked' until reviews complete, step 4 runs five validators plus a schedule builder, and the correction-after-sign-off procedure ('repeat checks and sign-off. Do not silently overwrite the prior record') is a genuine error-recovery feedback loop. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

SKILL.md is a clear overview that keeps detail in eight one-level-deep reference files, all of which exist in the bundle, each named with exact relative paths and surfaced in a 'Reference map' with one-line scope descriptions plus read-order guidance in references/README.md. Verified that no reference file points onward to another reference (no nesting), and all six asset templates and seven scripts referenced by path are present, matching 'clear overview with well-signaled one-level-deep references; easy navigation'.

5 / 5

Total

19

/

20

Passed

Description

82%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: third-person voice, clear what-and-when structure, concrete trigger phrases, and an explicit boundary against clinical decision-making. Its only notable gap is that it undersells the skill's operational capabilities (package generation, deterministic checks, schedule building), which leaves specificity short of comprehensive.

Suggestions

Add the skill's other concrete actions to the first sentence, e.g., 'Formats and structurally validates local treatment-plan documentation, generates template packages, and runs deterministic local checks...' to lift specificity from 2 named actions to several.

Include one or two common synonyms or concrete artifact terms users would naturally say, such as 'care plan documentation' or 'treatment plan JSON packages', to broaden trigger coverage toward natural variations.

DimensionReasoningScore

Specificity

The description names the domain ('local treatment-plan documentation') and two concrete actions ('Formats and structurally validates'), matching the 'domain plus 1-2 concrete actions, but not comprehensive' anchor. It omits other concrete capabilities the skill performs — generating template packages, running deterministic local checks, and producing explicit-date schedules — so it does not reach the 'several specific actions' level of 4.

3 / 5

Completeness

It explicitly answers both questions with concrete trigger phrases: what — 'Formats and structurally validates local treatment-plan documentation after clinical decisions have already been supplied and verified by authorized licensed professionals'; when — 'Use for source traceability, clinician-authored intervention records, goals and checkpoints, shared-decision records, reconciliation handoffs, and release gates—not for clinical decision-making.' This matches the top anchor exactly; it is not level 4 because the 'when' is not merely present but specific, enumerated, and paired with an explicit exclusion.

5 / 5

Trigger Term Quality

Phrases like 'treatment-plan documentation', 'source traceability', 'clinician-authored intervention records', 'goals and checkpoints', 'shared-decision records', 'reconciliation handoffs', and 'release gates' give good natural keyword coverage a clinician or documentation specialist would actually say, matching 'good keyword coverage; a few natural terms missing'. It falls short of 5 because common synonyms and format terms are absent (e.g., 'care plan', 'clinical documentation', 'JSON', 'discharge/transition summary').

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — post-decision, clinician-supplied treatment-plan documentation — with distinct triggers (traceability, reconciliation handoffs, release gates) and an explicit negative scope ('not for clinical decision-making') that prevents it from firing for diagnosis, therapy selection, or clinical advice skills. Conflict risk with other documentation skills is minimal; it does not fall to 4 because the exclusion clause removes the main overlap risk with general document-formatting skills.

5 / 5

Total

17

/

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

K-Dense-AI/scientific-agent-skills

Path

skills/treatment-plans/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.