novice-refactor

novice-refactor is a Docs writing & content skill for AI agents, published by prtamil in the AsciiCreativeCoding repository on GitHub. Skillspace rates novice-refactor D (62/100) and it passed the safety scan; the rating is based on static analysis only.

Trigger for the NOVICE_REFACTOR doctrine on a validated phase-2 C file — the textbook treatment for true beginners. Invoke when the user types `NOVICE_REFACTOR`, `COMPLETE_LITERATE` / `LITERATE` (legacy aliases), `/novice-refactor <filename>`, or asks to refactor a file so a first-time reader (no domain background) can learn the algorithm from zero. Reserve for the 5–10 canonical algorithm references in the project. Turns a working file into an embedded textbook via 3 sequential steps — (Step 0) color/HUD/themes, (Step 1) pseudocode-shaped code with extracted helpers, (Step 2) the full prose layer (file header + CONCEPTS + MENTAL MODEL with worked example + GUIDED TUTORIAL with construction-sequence lessons + Tier-1 function labels). Strictly clean-slate — read code only, never existing prose. For competent-learner files (the default case), use `default-refactor` instead.

Grade
D
Quality
62 / 100
Safety
Passed
GitHub stars
95

Unproven: rated by static analysis only, not yet compared head-to-head.

Our two independent classifiers differ on this skill's category, so treat the placement as provisional.

This rating describes the version of the repository we crawled; it may have changed since, so go by its current files.

View source on GitHubprtamil/AsciiCreativeCoding

Our review

Architecture
96 / 100
Maturity
Basic: a single SKILL.md
Security scan
Low-risk patterns
License
Not declared. Check the repository before reusing it.
Adoption
Adopted by 0 other repositories, in 0 collections

What the scanner flagged

  • mentions secrets in text

Not checked yet

  • Not judged on the rubric yet (not a contender in its category)
  • No blind task eval yet
  • Scope (portable / vendor / repo-internal) not assessed; only the top of each category is read for scope
  • Sibling files (scripts, references) not fetched; security scan covers SKILL.md only

Better-rated skills in Docs writing & content

Skillspace indexes and rates this skill; it does not host or endorse it. Run third-party skills at your own risk.