Skip to content
Skills Library
Education · Testing

drill

/drill

Use when a concept needs practising: the user asks for an exercise, quiz, recall, or gap probe. Not for explanations: use explain-concept.

Licence
Apache-2.0
Last repository change
28.09.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 28.09.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Use when a concept needs practising: the user asks for an exercise, quiz, recall, or gap probe. Not for explanations: use explain-concept.

Original author description

Use when a concept needs practising: the user asks for an exercise, quiz, recall, or gap probe. Not for explanations: use explain-concept.

How it works

  1. Contract
  2. Inputs
  3. Procedure
  4. Failure and recovery
  5. Output
Original SKILL.md headings · 43 lines, 986 words
SKILL.md preview
---
name: drill
description: 'Use when a concept needs practising: the user asks for an exercise, quiz, recall, or gap probe. Not for explanations: use explain-concept.'
---

# Drill

## Contract

| Field | Bound contract |
|---|---|
| Trigger | give me an exercise, quiz me, keep it fresh, what am I missing / where are my gaps, or explicit practice/quiz/recall/probe |
| Authority | Reversible local: writes only `PROGRESS.md` at the workspace root; rollback is deleting the lines this run appended. No remote mutation. The file is append-only, never rewritten. |
| Side effect | Appends one line per attempt to `PROGRESS.md` at the workspace root; drives spaced recall and probes gaps. |
| Done | The named move completed; every attempt recorded; cleared concepts marked no-hints-independent. |

## Inputs

- A concept name (required) and a move (optional): `practice`, `quiz`, `recall`, or `probe`.
- The move is optional: the routing table picks it, an explicit argument overrides, and no match defaults to `practice`.
- Optional: item count for `quiz` (default 5–8).
- `probe` requires `CORPUS.md` at the workspace root. `recall` requires prior `PROGRESS.md` history. State which is missing rather than inventing it.

## Procedure

1. Read `PROGRESS.md` at the workspace root (create it on first write) and, for `probe`, `CORPUS.md`. If neither `PROGRESS.md` nor `CORPUS.md` exists, say once that nothing is being recorded, ask which concept to work on, and run in-session only. Done when: `PROGRESS.md` is read or confirmed absent, and for `probe`, `CORPUS.md` is read or confirmed absent.
2. Pick the move. An explicit argument overrides the table; no match means `practice`. Table: "give me an exercise" / "let me practise X" / "walk me through one" → `practice`; "quiz me" / "test me on X" → `quiz`; "what should I review" / "keep it fresh" → `recall`; "what am I missing" / "where are my gaps" / "am I ready for X" → `probe`. Done when: the move is picked and stated.
3. Run one move per run. Another move is another run. Done when: one move is selected for this run.
4. `practice`: three rungs in this order, one rung per run: **worked** (the agent solves it and narrates why each step is taken; done when the full solution is narrated and the learner has answered one self-explanation prompt); **faded** (the agent solves everything but the last step and the learner finishes it; each further faded run removes one more step, always from the end backward, so the learner performs the final step every time; done when the learner has produced the step the rung asks and the attempt is recorded); **independent** (the learner solves it whole; done when the learner has produced the step the rung asks and the attempt is recorded). Advance a rung only when the current one was cleared without hints. Done when: the current rung is completed and recorded.
5. `quiz`: five to eight items unless the user asks for a different count, mixed between recall and application, over concepts already explained or cleared. The learner commits to an answer before anything is revealed. Done when: every item is graded and each miss names the misconception it reveals.
6. `recall`: a concept is due on an interval ladder counted from the date its independent rung was cleared: 1 day, 3 days, 7 days, 21 days, then every 60 days. Due means today is at or past the next interval with no retrieval recorded since. A missed retrieval resets that concept to the start of the ladder. Interleave across cleared concepts only. Two consecutive misses on one concept send it back to a faded rung. Done when: every due concept has been retrieved once and recorded.
7. `probe`: take what the learner says they want to do next, walk `CORPUS.md` back through the concepts it needs, ask one discriminating question per concept, then rank the confirmed gaps by how many downstream concepts each blocks. Done when: the ranked list is reported and every confirmed gap is recorded.
8. Hints: three tiers, released one at a time and on request: **nudge** (names the concept in play, no structure); **strategy** (the shape of the solution, no answer); **bottom out** (the step itself). Once a concept's independent rung is cleared with no hints, withdraw hints for that concept. Done when: hints are released on request and withdrawn for cleared concepts.
9. Grading: name the specific misconception an answer reveals rather than scoring it right or wrong. Say what the answer got right before what it missed. Release the solution once the learner has committed to an attempt. Done when: each answer is graded with its misconception named and the solution released.
10. Record every attempt in `PROGRESS.md` with this line shape: `- <YYYY-MM-DD> · <move>[/<rung>] · <cleared|missed>, hints <none|1|1-2|1-3>[, <misconception>]`. A concept is **cleared** when its `practice/independent` line reads `cleared, hints none`. Missed concepts are not cleared. Use the words **rung** and **cleared** and no synonyms. Done when: every attempt is recorded in `PROGRESS.md` with the correct line shape.

## Failure and recovery
- No `PROGRESS.md` and no `CORPUS.md`: say once that nothing is being recorded, ask which concept to work on, and run in-session. Do not create files for a `probe` that needs `CORPUS.md`.
- `probe` without `CORPUS.md`: blocked. Report the missing file; do not invent gaps or rank an empty list.
- `recall` with no cleared concepts: nothing is due. Report that and stop; do not fabricate a due set.
- Rung not cleared: do not advance. Record the miss with its misconception; do not rewrite `PROGRESS.md` (append only).
- Hints used on an independent rung: that concept is not cleared; record `hints 1` through `1-3` as used.
- Rollback: `PROGRESS.md` is append-only; recovery is deleting the lines this run appended. Never swallow a miss or mark cleared when hints were used.

## Output
One completed move plus one appended `PROGRESS.md` line per attempt (or in-session only when no files exist), with the rung outcome for `practice`, graded items for `quiz`, due concepts retrieved for `recall`, or a ranked gap list for `probe`.
Files in this package (3)
  • SKILL.md 6 KB
  • agents/openai.yaml 1 KB
  • references/DRILL-FORMAT.md 1 KB

Versions

RepositoryScoreLicence
This page · OutlineDriven/outline-driven-development90Apache-2.0
mattzimak/claude-cert-coach100MIT
pwguler/skills92MIT
mikeheid/overture90MIT

Database snapshot: 13.11.2026 · package version c8a530cba5b0 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100explain-concept
    Use when a concept needs making clear rather than practising: explain simply, why does this exist, draw it, or simplify for a beginner. Not for scaffolded practice: use drill.
  • 100explain-concept
    Use when a concept needs making clear rather than practising: explain simply, why does this exist, draw it, or simplify for a beginner. Not for scaffolded practice.
  • 90capstone
    Use when the learner is ready to apply cleared concepts in a real project. Not for exercises or quizzes: use drill.
  • 100teach-me
    Teach a technical concept to mastery. Teach it first on an interactive HTML lesson page, take questions, practice in chat, quiz with confidence ratings, drill gaps, re-quiz, and schedule spaced reviews. Use for learn, teach me, quiz me, review.
  • 90learning-coach
    Activates LearningCoach for adaptive education and curriculum design. Use when you need curriculum structure with learning objectives and assessments, Socratic teaching method with discovery-based explanations, concept maps and knowledge graph building, quiz and formative…
  • 95drill-me
    Teach the user a topic as an adaptive tutor — retrieval practice, spaced repetition with decay, and persistent memory in ~/.drill-me/. Use when the user wants to learn or be drilled on something, says "drill me on X", "teach me X", or wants to study a topic, a codebase, or a document.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.