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

47

Quality

49%

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/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 detection algorithm itself is well-specified with a clear step sequence, explicit indicator lists, and useful test scenarios. The main weaknesses are redundancy (repeated banner content, pseudocode restating the steps), an off-topic proactive-suggestions section that inflates token cost, and a monolithic structure with a dangling external reference.

Suggestions

Trim duplication: the 'Visual Indicator Update' section repeats banners already shown in the flow tables, and the pseudocode block restates the four detection steps — keep one canonical version of each.

Move the 'Proactive Skill Suggestions' section (~75 lines, including opt-out and detection signals) into a separate reference file or its own skill; it is a distinct feature from context detection.

Fix or remove the dangling reference to 'skills/blocks/codex-host-adapter.md', which does not exist in this bundle, and split the per-flow behavior tables into references/ files to shorten the always-loaded SKILL.md.

DimensionReasoningScore

Conciseness

The core detection algorithm is efficiently written, but there is notable padding: the banner examples in the flow tables are repeated verbatim in 'Visual Indicator Update', the 'Example Integration (Pseudocode)' restates the already-described steps, and the ~75-line 'Proactive Skill Suggestions' section is a second feature beyond context detection. Mostly efficient but could be tightened — anchor 3, not anchor 2 since most sections still carry real signal.

3 / 5

Actionability

There is an executable bash snippet for the explicit-mode check, explicit indicator term lists, and a concrete JSON output format, but the 'Example Integration' is explicitly pseudocode and the prompt-scoring logic ('count knowledge indicators... higher count wins') is described rather than given as runnable guidance. Some concrete guidance but incomplete with pseudocode — anchor 3.

3 / 5

Workflow Clarity

The detection algorithm is a clear 4-step sequence with an explicit override check, a default fallback, defined confidence levels, and a 'Testing Context Detection' section that acts as a verification checkpoint. Minor gaps (no stated handling when preference files are unreadable) keep it at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Sections are well-labeled and the per-flow tables are scannable, but the skill is a single ~270-line monolith with no bundle files: the flow-specific behavior tables and the proactive-suggestions feature are natural candidates for separate reference files, and the body references 'skills/blocks/codex-host-adapter.md', which does not exist in this bundle (dangling reference). Some structure but content that should be separate is inline — anchor 3.

3 / 5

Total

13

/

20

Passed

Description

42%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 communicates a clear niche (Dev vs Knowledge context auto-detection) but is underbuilt on the trigger side: no 'use when' guidance and no natural user-facing keywords. It reads more like an internal label than a discoverable skill description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when a workflow skill needs to decide between code-focused (Dev) and research/strategy-focused (Knowledge) behavior.'

Include natural trigger terms users would actually say, such as 'research', 'strategy', 'coding task', 'document work', or references to the /octo:km override.

Enumerate 2-3 concrete downstream actions (e.g. 'selects agents, output formats, and quality gates per context') to strengthen the what.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — 'Auto-detect work context (Dev vs Knowledge)' — but the rest ('use to tailor workflows based on current task type') is generic. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive), not anchor 4, which requires several specific actions.

3 / 5

Completeness

The 'what' is stated (auto-detect Dev vs Knowledge context, tailor workflows), but there is no 'use when' clause or equivalent trigger guidance, which caps this dimension at 3 per the judging guidelines. Not a 4 because 'when' is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

Only generic keywords appear ('work context', 'Dev', 'Knowledge', 'task type'); no natural phrases a user would actually say when needing this skill. It sits above anchor 1 (not pure jargon — 'Dev' and 'Knowledge' are real domain terms) but clearly below anchor 3, which requires relevant trigger keywords.

2 / 5

Distinctiveness Conflict Risk

'Dev vs Knowledge' context detection is a fairly distinct niche, but 'tailor workflows' is broad enough to overlap with any workflow skill. Somewhat specific but could still overlap with similar skills — anchor 3.

3 / 5

Total

11

/

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