CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-context-detection

Auto-detect work context (Dev vs Knowledge) — use to tailor workflows based on current task type

48

Quality

53%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/skill-context-detection/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 skill body presents a well-sequenced detection algorithm with concrete indicator lists, a defined output format, and verification steps. Its weaknesses are verbosity (duplicated banner examples, pseudocode restating the algorithm, a tangential proactive-suggestions section), non-executable presentation of the core scoring logic, and a monolithic single-file structure with no reference files.

Suggestions

Replace the "Example Integration (Pseudocode)" block with a single executable detection script (or point to one in scripts/), and delete the redundant restatement of Steps 1-4.

Move the per-flow context tables (flow-discover/develop/deliver), banner templates, and proactive-suggestion tables into one-level-deep reference files (e.g. references/flow-matrix.md, references/banners.md) and keep only the detection algorithm in SKILL.md.

Drop one of the two near-identical visual banner examples and trim the "Proactive Skill Suggestions" section to a brief pointer, since it describes a separate feature from context detection.

DimensionReasoningScore

Conciseness

Most sections convey skill-specific information rather than general concepts, but there is real padding: the "Example Integration (Pseudocode)" block re-describes the detection algorithm already specified in Steps 1-4, the two full visual-banner blocks duplicate each other almost line-for-line, and the "Proactive Skill Suggestions" section drifts into a separate feature (work-stage tips) beyond context detection. This fits anchor 3 — mostly efficient but with unnecessary sections that could be trimmed — rather than anchor 4's minor over-explanation.

3 / 5

Actionability

The Step 1 override check is executable bash and the indicator lists plus JSON output format are concrete, but the core scoring algorithm ("Count knowledge indicators in prompt... Higher count wins") is prose description rather than an executable check, and the main integration example is explicitly pseudocode. This matches anchor 3 (some concrete guidance, pseudocode where executable code is needed) and not anchor 4's mostly-executable bar.

3 / 5

Workflow Clarity

The detection algorithm is a clearly sequenced four-step process with an explicit precedence order (explicit override, prompt analysis, project context, fallback default), defined confidence levels, and a verification section ("Testing Context Detection"). It matches anchor 4 — clear sequence with most checkpoints present — falling short of anchor 5 only because there is no built-in feedback loop when detection confidence is low beyond a suggestion to mention it to the user.

4 / 5

Progressive Disclosure

The body has good section headers and is navigable, but it is a single ~270-line monolith with no bundle files at all: the per-flow agent/quality-gate tables, the banner templates, and the proactive-suggestions material are all inlined when they are natural candidates for one-level-deep reference files. This fits anchor 3 (some structure, content that should be separate is inline) rather than anchor 4's mostly-appropriate placement; the under-50-line exception does not apply.

3 / 5

Total

13

/

20

Passed

Description

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

The description clearly states what the skill does and defines its two-context domain, but it lacks an explicit 'Use when...' trigger clause and leans on project-internal jargon users would not naturally say. It is serviceable but noticeably below the quality of the reference good examples.

Suggestions

Add an explicit trigger clause, e.g. "Use when a workflow skill activates and the task could be code-focused (Dev) or research/strategy-focused (Knowledge)."

Include natural user-facing trigger phrases (e.g. "research", "PRD", "market analysis" vs "implement", "debug", "refactor") so the description matches what users actually say.

Name the concrete detection actions (prompt indicator scoring, project-type analysis, explicit override check) instead of the generic "tailor workflows".

DimensionReasoningScore

Specificity

"Auto-detect work context (Dev vs Knowledge)" names the domain and one concrete action (auto-detection), and "tailor workflows based on current task type" gestures at a second. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it lacks the multiple specific actions of anchor 4, but is more concrete than the purely generic anchor 2.

3 / 5

Completeness

The "what" is clear (auto-detect Dev vs Knowledge context), but the closest thing to a "when" is the purpose clause "use to tailor workflows based on current task type", which describes intent rather than trigger conditions. Per the guideline that a missing or only weakly implied 'Use when...' caps completeness at 3, this fits anchor 3 and not anchor 4's explicit 'when'.

3 / 5

Trigger Term Quality

Keywords like "work context", "Dev", "Knowledge", "workflows", and "task type" are relevant to the skill's niche, but they are project-internal jargon rather than phrases a user would naturally say. Some relevant keywords exist (anchor 3) yet natural user phrasings and synonyms are missing, keeping it below anchor 4.

3 / 5

Distinctiveness Conflict Risk

The Dev-vs-Knowledge framing is a reasonably distinct niche within this bundle, but "tailor workflows based on current task type" is broad enough to overlap with other workflow skills. It sits at anchor 3 — somewhat specific but with residual overlap risk — rather than anchor 4's mostly-distinct profile.

3 / 5

Total

12

/

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
nyldn/claude-octopus
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.