neomatrix369/learning-opportunity

Progressive concept teaching through three depth levels (Core → Mechanics → Deep Dive). Creates diagrams, provides annotated code walkthroughs from the current codebase, and builds explanations from fundamentals to production internals. Triggers: "teach me about [pattern/concept]", "how does [architecture/pattern] work", "walk me through [this implementation]", "tutorial on [concept]", "deep dive into [system/pattern]", "help me understand [this design]" Use when: user requests multi-level learning about code patterns, architecture, or implementation mechanics with checkpoint-based progression. Not for: quick answers, single-sentence explanations, code fixes, or "what does this line do" questions—those are standard assistance.

1.44x

Quality

100%

Does it follow best practices?

Impact

97%

1.44x

Average score across 5 eval scenarios

Skill Improvements Applied

Name: neomatrix369/learning-opportunity
Rating: 0.988 (1 reviews)
Author: neomatrix369

Results Summary

Score: 77% → 89% (+12%)
Token count: 978 → 890 (9.4% reduction)
Validation: 3 warnings → 1 warning

Changes Applied

1. Added Concrete Examples ✅

Created examples.md with complete Level 1-3 walkthrough of dependency injection:

Shows actual teaching output format
Demonstrates checkpoint phrasing
Provides file:line reference style

2. Removed Redundant Sections ✅

Condensed "Philosophy" and "Target audience" into brief intro
Removed duplicated trigger lists from main SKILL.md
Eliminated checkpoint template repetition

3. Progressive Disclosure ✅

Created separate reference files:

trigger-reference.md - Complete trigger word list
examples.md - Full teaching examples
visualization-guide.md - Diagram decision tree (already existed)

4. Fixed Metadata ✅

Added license: MIT
Added metadata.version: 0.1.0
Structured metadata as dictionary

5. Improved Structure ✅

Added explicit workflow with ordered list
Consolidated checkpoint templates
Clearer section separation
Better file references

Remaining Considerations

Orphaned Files Warning

The include field in tile.json doesn't prevent the orphaned files warning. This appears to be a linter quirk—the files are properly linked via references in SKILL.md.

Metadata Version Warning

Added version to metadata, but one warning remains (likely linter expecting different format).

File Structure

learning-opportunity/
├── SKILL.md (84 lines, down from 85)
├── tile.json (updated with license)
├── examples.md (NEW - teaching examples)
├── trigger-reference.md (NEW - trigger patterns)
├── visualization-guide.md (existing)
└── IMPROVEMENTS.md (this file)

Next Steps

If you want to further improve the score, consider:

Add inline abbreviated example in SKILL.md (judge suggested)
Include sample checkpoint dialogue
Explore why orphaned file warning persists despite include field

Install with Tessl CLI

npx tessl i neomatrix369/learning-opportunity

evals

visualization-guide.md