CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-knowledge-work

Switch to Knowledge Work mode for research and writing — use when task is non-code focused

49

Quality

54%

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/skill-knowledge-work/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 provides genuinely actionable commands and concrete file formats, but it carries substantial duplication and background explanation that inflates token cost without adding guidance. The learnings workflow lacks validation despite including an automatic destructive pruning step, and the ~215-line single-file layout inlines reference material that should be split out.

Suggestions

Collapse the duplicate command listings into one table and cut the four repeated banner mockups to a single illustration, roughly halving the body while keeping every instruction.

Move the auto-detection heuristics, learnings JSON schema, and budget rules into reference files (e.g. references/detection.md, references/learnings.md), leaving SKILL.md a lean overview with clearly signaled links.

Add a validation step before pruning learning files (e.g. verify age/relevance before deletion) and a checkpoint in the learnings workflow to lift the workflow-clarity cap.

DimensionReasoningScore

Conciseness

The body is noticeably verbose with padded, duplicated sections: the /octo:km commands are listed twice ("Override Commands" prose plus the "Override Command Reference" table), the octopus banner is printed four times across the examples, and multi-paragraph sections ("How Auto-Detection Works", "Cross-Task Learnings", "Related Skills") explain background system behavior that adds tokens without guiding action. It is not 1 because it never explains general concepts Claude already knows, and not 3 because the duplication and illustrative-example padding are pervasive rather than isolated.

2 / 5

Actionability

Commands are concrete and copy-paste ready ("/octo:km on", "/octo:km off", "/octo:km auto"), the learnings workflow specifies exact paths (".claude-octopus/learnings/<date>-<summary>.json") and a complete JSON example with field definitions. It is not 5 because sizable portions (auto-detection internals, repeated banners) describe behavior rather than instruct, and the workflow-to-context mapping is stated as a table without executable guidance.

4 / 5

Workflow Clarity

The core toggle action is unambiguous, but the multi-step Cross-Task Learnings workflow (extract at session end, match at session start, prune oldest files beyond 50) lists steps with no validation checkpoints, and automatic pruning of learning files is a destructive batch operation without any verification step. Per the rubric's cap, a workflow with destructive/batch operations and no validation cannot exceed 3. It is above 2 because sequences are clearly and coherently listed.

3 / 5

Progressive Disclosure

The body is ~215 lines with well-labeled sections but everything is inline; reference material that belongs in separate files — the auto-detection heuristics, the four banner examples, and the learnings JSON schema/budget rules — could be split out to keep SKILL.md a lean overview. It is not 4-5 because content that should be in reference files is inlined, though the section headers keep it navigable rather than a monolithic wall (anchor 2).

3 / 5

Total

12

/

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.

The description is compact and answers both what the skill does and when to use it, with a clear explicit "use when" clause. Its main weaknesses are minimal capability detail and thin trigger-term coverage — only a single abstract condition ("non-code focused") with no synonyms or concrete trigger phrases.

Suggestions

Enumerate the concrete capabilities rather than a single action, e.g. "Switches Claude Octopus workflows between Dev and Knowledge context for research, strategy docs, presentations, and report generation".

Add natural trigger phrases users would actually say, such as "Use when the user asks for knowledge/research mode, wants non-code workflows, or says 'force knowledge' or 'force dev'".

Include the specific commands or workflows affected (e.g. /octo:km on/off/auto) to sharpen distinctiveness against generic research or writing skills.

DimensionReasoningScore

Specificity

"Switch to Knowledge Work mode" names the domain ("research and writing") and one concrete action, matching the anchor for naming a domain with 1-2 concrete actions but not comprehensive coverage. It is not score 2 because it does state an actual action beyond a bare domain label, and not score 4 because no additional capabilities are enumerated.

3 / 5

Completeness

Both parts are present: the "what" ("Switch to Knowledge Work mode for research and writing") and an explicit "when" clause ("use when task is non-code focused"). It is not 5 because the trigger is a single abstract condition with no concrete trigger phrases, and not 3 because the "when" is explicitly stated rather than merely implied.

4 / 5

Trigger Term Quality

It includes some relevant natural terms ("research", "writing", "non-code") but misses common variations and synonyms users might say ("knowledge work", "document", "strategy", "market research"). It lacks the broader keyword coverage of anchor 4 while going beyond the single generic keyword of anchor 2.

3 / 5

Distinctiveness Conflict Risk

"Knowledge Work mode" and "non-code focused" carve out a recognizable niche, but the description could still overlap with general research/writing or document skills. It is more specific than anchor 2's broad overlap but does not have the distinct, concrete triggers of anchor 5.

3 / 5

Total

13

/

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.