Skip to content
Back to skills

Reformulation

ASecurity

Rewrite, in place, a section of a note the learner did not understand, using a different explanatory approach chosen from their learning style, then check understanding again. Use when the learner says they do not get a note/section/concept, or on /reformulate.

  • 3 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agents

Works with

  • cli

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add Lelpoco2/learning-curve --skill reformulation --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Reformulation?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Reformulation
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/lelpoco2-reformulation/badge)](https://www.skillsdirectory.com/skills/lelpoco2-reformulation)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: reformulation
description: Rewrite, in place, a section of a note the learner did not understand, using a different explanatory approach chosen from their learning style, then check understanding again. Use when the learner says they do not get a note/section/concept, or on /reformulate.
---

# Reformulation

Trigger: ONLY when the learner says they do not understand something in a note (or runs
`/reformulate`). Do not reformulate on your own initiative.

## 1. Diagnose before rewriting

1. Identify the note and the exact section (ask if unclear; read the note).
2. Ask ONE short diagnostic question to find where understanding breaks: the
   motivation? a specific step? the notation? the definition itself? Often the block is
   a missing prerequisite or a jump between two steps.

## 2. Choose a different approach

Check the Learning Style summary and recent observations (`learner_profile` get). Pick
an approach different from the one that failed:

| Failed approach | Try |
|---|---|
| Formal derivation | Concrete numbers first, then generalise |
| Abstract picture | Physical analogy or everyday situation |
| Words only | A figure, plot or short animation (skill `visuals`) |
| Big step | Smaller steps, each with a one-line reason |
| Heavy notation | Words first, then introduce symbols one at a time |
| Single example | Contrast: example vs non-example |

If a prerequisite is missing, add a short folded "Refresher" callout before the section.

## 3. Rewrite in place

1. Replace ONLY the unclear section with `edit` (keep the rest of the note intact).
2. Keep the logical thread: the new text must connect with the text before and after.
3. Keep the lesson layout of its kind (skill `lesson-writing` and the kind's template): dotted heading numbers in order (renumber
   the following sections and "§" references if you add or remove one), one blank line
   after each heading, the formal `[!info]` statement of the concept unchanged unless it
   was wrong — reformulate the explanation around it, not the definition.
4. Verify any new math with `math_check`.
5. Increase the note's `revision` property by 1 and set `updated`. If flashcards are
   enabled and the lesson's cards relied on the old explanation, update its section in the
   topic's Flashcards note.

## 4. Check and learn

1. Ask one guided question on the rewritten part (`quiz_ask`, guided, with hints).
   If the "How to remember it" tips relied on the approach that failed, replace them with
   tips that fit the new one (skill `memory-aids`).
2. Record what happened with `learner_profile` observe: the failed approach
   (`does-not-work`) and, if it now clicks, the new one (`works`), with evidence.
3. If the same kind of approach keeps failing, update the Learning Style Summary bullets.
4. If it still does not click after two reformulations, step back: likely a missing
   prerequisite. Propose a short prerequisite mini-lesson (add it to the plan).

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.