CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

security-health-inline

Inline orchestration workflow for security vulnerability detection and remediation with Beads integration. Provides step-by-step phases for security-scanner detection, priority-based fixing with vulnerability-fixer, and verification cycles.

56

Quality

70%

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 ./.claude/skills/security-health-inline/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 well-sequenced, highly actionable orchestration workflow whose strongest suit is workflow clarity — validation gates, iteration caps, and rollback paths are all explicit. Its weaknesses are redundancy (TodoWrite JSON and Quick Reference table restate the phases) and a monolithic single-file layout with no progressive disclosure despite ~310 lines of material.

Suggestions

Move the TodoWrite template, the Phase 7 summary template, and the full subagent prompts into reference files (e.g. references/templates.md) and link to them one level deep, keeping SKILL.md as the orchestration overview.

Drop or shrink the Quick Reference table — it duplicates the Beads commands already shown in each phase — and condense the TodoWrite JSON to a one-line list of step names.

Specify the state-tracking mechanics the workflow assumes: how the issue-ID-to-priority mapping and the iteration counter are maintained across phases.

DimensionReasoningScore

Conciseness

Mostly command-and-template driven with no padding that explains concepts Claude already knows, but it can be tightened: the 8-entry TodoWrite JSON restates the phase list verbatim, the Quick Reference table repeats the Beads commands already shown in each phase, and the full markdown summary template in Phase 7 is long. Not 4 because these redundant sections are a noticeable trim opportunity; not 2 because there is no concept over-explanation and the bulk is genuinely actionable material.

3 / 5

Actionability

Gives exact executable commands (`bd mol wisp exploration`, `bd create ... --deps discovered-from:{wisp_id}`, `pnpm type-check && build`), verbatim Task-tool prompts for the subagents, and concrete output templates. Not 5 because a few steps rely on unspecified state — the issue-ID-to-priority mapping, the iteration counter checked in Phase 6, and how security-scan-report.md is parsed are all assumed rather than given; not 3 because nothing is pseudocode and nearly everything is copy-paste ready.

4 / 5

Workflow Clarity

Seven phases are explicitly sequenced with a stated max-iteration loop (Phase 6 verification → back to Phase 2, capped at 3), quality gates (`pnpm type-check` + `pnpm build`) after every priority tier, a TodoWrite checklist, backup/rollback instructions in Error Handling, and explicit decision branches at each checkpoint (zero-vulns skip, fail→exit, remaining→re-scan). This matches the anchor for explicit validation steps, feedback loops, and checklists for a complex process; the batch-fixing workflow clearly exceeds the cap concern since validation is pervasive.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so all ~310 lines live in SKILL.md. Section headers and the phase structure give it reasonable organization, but content that naturally belongs in separate files — the TodoWrite template, the final-summary markdown template, the full subagent prompts, and the Error Handling/rollback detail — is inlined, and there are no one-level-deep references to offload any of it. Not 2 because the structure is clear with well-labeled sections, not a wall of text; not 4 because nothing is split out and the single file is long for a SKILL.md overview.

3 / 5

Total

15

/

20

Passed

Description

58%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 clear, third-person, moderately specific description that says what the skill does but never says when to use it. The vocabulary is on-domain but thin on natural user phrasings, leaning on internal tool names (Beads, security-scanner, vulnerability-fixer) that users may not say verbatim.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for a security scan, security audit, vulnerability check, or security health check of the codebase.'

Broaden natural keywords to include synonyms users actually say: 'security scan', 'security audit', 'vulnerability scan', 'security check', 'hardening'.

Trim internal jargon (e.g. 'Inline orchestration workflow', 'Beads integration') in favor of user-facing capability terms like 'scans the codebase for vulnerabilities, fixes them by priority, and verifies the fixes'.

DimensionReasoningScore

Specificity

Names several concrete actions — "security vulnerability detection and remediation", "security-scanner detection, priority-based fixing with vulnerability-fixer, and verification cycles" — plus named tools (Beads, security-scanner, vulnerability-fixer). Not 5 because coverage is incomplete: no mention of the vulnerability categories scanned (SQL injection, XSS, secrets), the priority tiers, or the quality-gate/build validation it performs. Not 3 because it lists more than 1-2 concrete actions with tool-level specificity rather than a single generic capability.

4 / 5

Completeness

The "what" is clear and fairly detailed (detection, priority-based fixing, verification cycles), but there is no "Use when..." clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. Not 2 because the "what" is concrete, not vague; not 4 because "when" is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Relevant keywords are present ("security", "vulnerability", "detection", "remediation", "fixing") but natural user phrasings like "security scan", "security audit", "security check", or "hardening" are missing. Not 4 because the term set is narrow and tool-jargon-heavy ("Beads integration", "Inline orchestration") rather than covering common variations; not 2 because the core security/vulnerability vocabulary is on-target, not generic.

3 / 5

Distinctiveness Conflict Risk

Occupies a fairly distinct niche — an orchestrated detect→fix→verify security workflow with Beads issue tracking — with specific companion agent names (security-scanner, vulnerability-fixer) that other skills are unlikely to share. Not 5 because "security vulnerability detection and remediation" broadly overlaps any general security-scanning or code-review skill; not 3 because the orchestration-workflow framing and tool integration make it substantially more specific than "works with document files"-level generality.

4 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

maslennikov-ig/claude-code-orchestrator-kit

Path

.claude/skills/security-health-inline/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.