CtrlK
BlogDocsLog inGet started
Tessl Logo

rp-why

Gas Town × DOK Framework - A two-dimensional model for analyzing AI collaboration maturity and cognitive complexity to reveal growth opportunities.

26

Quality

17%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./rp-why/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

7%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description relies heavily on proprietary framework names and abstract conceptual language without explaining what concrete actions the skill performs or when it should be triggered. It reads more like a tagline than a functional description, making it very difficult for Claude to know when to select this skill from a list of alternatives.

Suggestions

Add a 'Use when...' clause with explicit trigger scenarios, e.g., 'Use when the user asks to assess their team's AI adoption level, evaluate cognitive depth of AI tasks, or map collaboration maturity.'

Replace abstract language with concrete actions the skill performs, e.g., 'Scores teams on a maturity scale, maps tasks to DOK cognitive levels, generates gap analysis reports, and recommends next steps for AI integration.'

Include natural keywords users might say, such as 'AI readiness assessment', 'team maturity evaluation', 'collaboration analysis', or 'cognitive complexity scoring'.

DimensionReasoningScore

Specificity

The description uses abstract, conceptual language ('two-dimensional model', 'analyzing AI collaboration maturity', 'cognitive complexity', 'reveal growth opportunities') without listing any concrete actions the skill performs. There are no specific verbs describing what the skill actually does.

1 / 3

Completeness

The 'what' is vaguely described as analyzing maturity and complexity, but there is no explicit 'when' clause or trigger guidance. The description lacks a 'Use when...' clause, and even the 'what' is too abstract to be actionable.

1 / 3

Trigger Term Quality

The terms 'Gas Town', 'DOK Framework', 'AI collaboration maturity', and 'cognitive complexity' are specialized jargon that users would be unlikely to naturally say. There are no common, natural trigger terms a user would use when needing this skill.

1 / 3

Distinctiveness Conflict Risk

The specific framework names 'Gas Town' and 'DOK Framework' provide some distinctiveness, making it unlikely to conflict with generic skills. However, the vague domain of 'AI collaboration' could overlap with other AI-related analysis skills.

2 / 3

Total

5

/

12

Passed

Implementation

27%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill reads more like a comprehensive documentation page or README than an actionable skill for Claude. It spends most of its token budget explaining the conceptual framework (Gas Town stages, DOK levels, integration matrix) rather than providing concrete implementation instructions for how to actually perform the analysis. The content is well-organized with tables and visual elements, but is far too verbose for a skill file and lacks the executable specificity needed to guide Claude's behavior.

Suggestions

Drastically reduce the framework explanation sections—Claude can understand DOK and Gas Town from brief definitions. Move detailed reference tables (user profiles, growth nudges, full stage descriptions) to separate bundle files.

Add concrete implementation logic: how should Claude classify a prompt's DOK level? What heuristics determine Gas Town stage? Provide specific classification rules or decision trees rather than just descriptions.

Remove the installation instructions, version history, problem statement, and attribution sections—these consume tokens without helping Claude execute the skill.

Split into SKILL.md (overview + commands + classification logic) with references to FRAMEWORK.md (detailed matrix/zones), NUDGES.md (growth nudge reference), and PROFILES.md (target user profiles).

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~300+ lines, explaining concepts Claude already knows (what DOK is, what Gas Town stages are, what a PDF is equivalent-level explanations of frameworks). The problem statement section, target user profiles, growth nudge reference, and version history all add significant token bloat. Much of this is reference material that Claude doesn't need spelled out in full—the integration matrix alone could be condensed significantly.

1 / 3

Actionability

The skill provides slash commands and natural language alternatives, plus a sample output format, which gives some concrete guidance. However, there is no executable code, no implementation logic for how to actually perform the analysis (e.g., how to classify prompts into DOK levels programmatically, how to detect Gas Town stage), and the commands are described rather than implemented. It's more of a conceptual framework description than actionable instructions.

2 / 3

Workflow Clarity

The three commands (current, init, compare) are listed with their outputs, and there's a 'When to Use' section suggesting timing. However, there are no validation checkpoints, no error handling guidance, no feedback loops for when analysis seems wrong, and the workflow for establishing and comparing baselines lacks explicit sequencing with verification steps.

2 / 3

Progressive Disclosure

This is a monolithic wall of text with no references to external files despite having extensive reference material (growth nudges, user profiles, framework definitions, attribution) that could easily be split out. Everything is inline in one massive document with no bundle files to support it. The integration matrix, target user profiles, and growth nudge reference sections are all candidates for separate reference files.

1 / 3

Total

6

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
block/agent-skills
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.