CtrlK
BlogDocsLog inGet started
Tessl Logo

project-guide

Simulates plan mode with a teaching-first approach. Use when onboarding to a new codebase, exploring architecture, or seeking guided understanding of any project area. Produces high-level overviews with diagrams, drills into details on request, and offers follow-up exploration questions.

68

1.33x
Quality

57%

Does it follow best practices?

Impact

84%

1.33x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/project-guide/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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 has good structural completeness with an explicit 'Use when' clause and reasonable specificity about what it produces. Its main weaknesses are somewhat abstract framing ('simulates plan mode with a teaching-first approach') and limited trigger term coverage that misses common natural language users would employ when seeking codebase understanding. The description could also be more distinctive to avoid overlap with general code explanation or documentation skills.

Suggestions

Add more natural trigger terms users would say, such as 'explain the code', 'walk me through', 'how does this work', 'code tour', or 'understand this project'.

Replace the abstract 'simulates plan mode with a teaching-first approach' with more concrete language describing the skill's unique behavior, e.g., 'Provides structured codebase walkthroughs with ASCII diagrams and progressive detail levels'.

DimensionReasoningScore

Specificity

Names the domain (codebase onboarding, architecture exploration) and some actions (produces overviews with diagrams, drills into details, offers follow-up questions), but 'simulates plan mode with a teaching-first approach' is somewhat abstract and the concrete actions could be more specific.

2 / 3

Completeness

Clearly answers both what ('produces high-level overviews with diagrams, drills into details on request, offers follow-up exploration questions') and when ('Use when onboarding to a new codebase, exploring architecture, or seeking guided understanding of any project area') with an explicit 'Use when' clause.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'onboarding', 'codebase', 'architecture', and 'guided understanding', but misses common natural variations users might say such as 'explain the code', 'how does this work', 'walk me through', 'understand the project', or 'code tour'.

2 / 3

Distinctiveness Conflict Risk

The 'teaching-first approach' and 'plan mode' framing provide some distinctiveness, but terms like 'exploring architecture' and 'guided understanding' could overlap with general code explanation or documentation skills. The niche is somewhat clear but not sharply delineated.

2 / 3

Total

9

/

12

Passed

Implementation

47%

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

This skill has a well-structured workflow with clear phases and useful output templates, but is severely undermined by verbosity. It spends significant tokens teaching Claude concepts it already knows (how to teach, progressive disclosure, handling complexity, adapting to audience levels). The content would benefit enormously from aggressive trimming to focus on the specific output formats and phase structure, moving pedagogical philosophy to referenced files or removing it entirely.

Suggestions

Remove the Teaching Philosophy, Adaptive Teaching Techniques, and Handling Complexity sections entirely—Claude already knows how to teach and adapt to audience levels. This alone would cut ~40% of the content.

Consolidate the Anti-Patterns table into 2-3 key constraints rather than 7 rows of guidance Claude already follows naturally.

Move the detailed phase templates (Phase 2-4 output formats) into the referenced interaction-template.md file, keeping only a brief summary of each phase in SKILL.md.

Actually provide the referenced bundle files (diagram-patterns.md, interaction-template.md) or remove the references to avoid dead links.

DimensionReasoningScore

Conciseness

Extremely verbose at ~250+ lines. Much of the content teaches Claude how to teach—concepts like progressive disclosure, mental model building, and adaptive teaching techniques that Claude already knows. The teaching philosophy section, adaptive teaching techniques, and handling complexity sections are all things Claude inherently understands. The anti-patterns table restates common sense. This skill could be reduced to ~30% of its size.

1 / 3

Actionability

Provides structured templates and output formats which give some concrete guidance, but the skill is fundamentally about a soft process (guided exploration) rather than executable commands. The templates are useful but are more like suggested prose structures than copy-paste-ready code. The Mermaid and ASCII diagram examples are concrete and helpful, but much of the guidance remains descriptive rather than directly executable.

2 / 3

Workflow Clarity

The four-phase workflow (First Impressions → Architecture Deep Dive → Focused Exploration → Follow-Up Questions) is clearly sequenced with explicit output formats for each phase. The example session flow at the end demonstrates how phases connect. For this type of non-destructive, conversational skill, validation checkpoints aren't critical, and the workflow is unambiguous.

3 / 3

Progressive Disclosure

References diagram-patterns.md and interaction-template.md in a supporting files table, which is good structure. However, neither file exists in the bundle, so the references are unverifiable. More importantly, the SKILL.md itself is monolithic—the adaptive teaching techniques, handling complexity, and anti-patterns sections could easily be in separate referenced files rather than inline, making the main file leaner.

2 / 3

Total

8

/

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
0xrabbidfly/eric-cartman
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.