challenge-me
Skill0 starsChanged 19 days agoMITView on GitHub
Stress-test a document, plan, idea, design, or architecture by grilling like a critical manager: numbered questions with recommended answers, glossary and ADR alignment, blunt challenge of estimates and hidden work, plus structured brainstorming that ends in an approved design brief (approaches with trade-offs, play-backs, a fresh-reader check), a compact decision map, and a sharpen mode that makes a task prompt deeper before work starts. Use when the user says grill me, grill this doc, stress-test this plan, challenge this idea, poke holes, decision-map, sharpen this prompt, or brainstorm a design before coding. Not for executing a refactor (safe-refactor), writing implementation-plan files (write-plan), inventing a target stack (super-tech-blueprint), or reviewing code or a diff (second-opinion).
3 other projects use a version of this.
Adopted by
Most recently taken up by
- rikilamadrid/lorekeepertheir own version, first seen Oct 13, 2026
- rikilamadrid/pathfindertheir own version, first seen Sep 30, 2026
- milistu/agent-skillstheir own version, first seen Mar 2, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- milistu/agent-skills★ 8same name
- rikilamadrid/lorekeeper★ 1same name
- rikilamadrid/pathfinder★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository57 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .cursor/rules/comments.mdcCursor rule
- .cursor/rules/commit-messages.mdcCursor rule
- .cursor/rules/git-workflow.mdcCursor rule
- .cursor/rules/manage-stack.mdcCursor rule
- .cursor/rules/no-worktrees.mdcCursor rule
- manage-stackSkill
- convert-as-skillSkill
- create-agentSkill
- create-agents-mdSkill
- create-commandSkill
- create-hookSkill
- create-ruleSkill
- create-skillSkill
- retrospectiveSkill
- super-architectureSkill
- super-cachingSkill
- super-elixirSkill
- super-nodejsSkill
- super-protobufSkill
- super-tech-blueprintSkill
- atomic-semantic-commitSkill
- code-reviewSkill
- create-bruno-collectionSkill
- create-documentationSkill
- create-ticketsSkill
- ready-specSkill
- write-adrSkill
- write-changelogSkill
- write-mr-descriptionSkill
- write-planSkill
- write-postmortemSkill
- write-runbookSkill
- noslopSkill
- output-saversSkill
- safe-refactorSkill
- tddSkill
- verifySkill
- get-movingSkill
- later-listSkill
- standupSkill
- codebase-learnerSkill
- researchSkill
- second-opinionSkill
- traceSkill
- color-kitSkill
- design-system-kitSkill
- diagramSkill
- infographicSkill
- product-polish-workflowSkill
- prototype-wireframeSkill
- ui-ux-kitSkill
- evidenceSkill
- find-skillsSkill
- handoffSkill
- rumblingSkill
- use-levistackSkill
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 6 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 37
Facts vs decisions: Look up what the repo or docs already answer.
- Distinctive: line 38
Numbered question + recommended answer, then wait: Never dump an interrogation without a rec.
- Distinctive: line 40
Past the first three: Do not stop at the obvious answers.
- Very specific: line 41
Stop at shared understanding: Do not execute a refactor, invent a stack, or write docs/superpowers/plans/*.md unless the user asks.
- Distinctive: line 47
Do this first; do not announce it.
- Very specific: line 86
Do not absorb do / make-plan orchestrators.
- Distinctive: line 122
Every asked question had a number and a recommended answer.
- Distinctive: line 125
No implementation-plan file, refactor, or invented stack unless they explicitly asked for that handoff.
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Challenge me
One interview skill for a document, plan, idea, design, architecture, or anything else that needs shared understanding. Act like a manager: critical questions, then brainstorming, then a locked map of decisions. Stop there unless the user asks to write a plan artifact or tickets.
Research notes: research-synthesis.md. Question shape: round-format.md, templates/round.md.
Principles
- Facts vs decisions. Look up what the repo or docs already answer. Only the user decides trade-offs. See facts-vs-decisions.md.
- Numbered question + recommended answer, then wait. Never dump an interrogation without a rec. Default one-at-a-time; switch to a frontier round when the user asks or after calibrate.
- Attack the work, not the person. Intensity is a dial. Thermonuclear is off unless they opt in (intensity.md).
- Past the first three. Do not stop at the obvious answers; force at least one non-obvious option, then pick. Not a multi-agent loop.
- Stop at shared understanding. Do not execute a refactor, invent a stack, or write
docs/superpowers/plans/*.mdunless the user asks. Then hand off (peers below). - Language-agnostic. The round format works in any language; do not load a second language pack.
- Design gate (brainstorm). Nothing gets built until the user approves the design brief. See design-brief.md.
Step 0: pick a mode
Do this first; do not announce it. Load only that mode file plus the core files it names.
| If the user wants… | Mode | Load |
| Walk a design tree, grill me, stress-test this plan/idea/architecture | grill | grill.md |
| Grill against CONTEXT.md, glossary, ADRs, existing docs | grill-docs | grill-docs.md |
| Blunt advisor: estimates, hidden work, overcomplication | challenge | challenge.md |
| Ideas → design before implementation (new or existing product) | brainstorm | brainstorm.md |
| Compact stateful map across sessions, or work too big for one session | decision-map | decision-map.md |
| Make a task or prompt deeper before work starts, then rewrite it | sharpen | sharpen.md |
| Softer/harder, one-at-a-time vs frontier-round | calibrate | intensity.md |
| Mermaid/PlantUML as an aid, not a diagram takeover | mindmap | mindmap.md |
Precedence: explicit mode → artifact (docs present → grill-docs; "too big"/"hidden work" → challenge; "just an idea"/no design yet → brainstorm; resume later or too big for one session → decision-map; "make this prompt better" → sharpen) → default grill. Combine grill + grill-docs when they bring a plan and domain docs. Run calibrate whenever they say softer, harder, batch, or one-by-one; keep the setting for the session.
Loop mechanics: interview-loop.md. Frontier rounds: frontier.md. Brainstorm extras: approaches.md, play-back.md, design-brief.md.
Domain tracks (optional)
Subject is not a mode. After the mode, load at most one stub if the artifact is clearly in that world. Index and how to add a track: domains/README.md.
| Subject | Stub |
| Product / marketplace / new vs existing offering | product.md |
| Engineering / architecture / APIs | engineering.md |
| UI, UX, visual design | design-ui.md |
| Prose, specs, narrative docs | writing.md |
Peers (do not duplicate)
| Job | Skill |
Current-repo facts, smells, ARCHITECTURE.md | codebase-learner (diagnose pairs with grill-docs) |
| Target stack / migration blueprint | super-tech-blueprint — do not invent stacks here |
| Execute a refactor | safe-refactor |
| Write the implementation-plan file | write-plan |
| Pause/resume the session | handoff |
| Tickets after grilling | create-tickets |
Do not absorb do / make-plan orchestrators. If they want subagent execution, point at write-plan then handoff.
Layout
challenge-me/
├── SKILL.md
├── references/core/ # loop, frontier, facts vs decisions, intensity, round rules, mindmap, research, approaches, play-back, design brief
├── references/modes/ # grill, grill-docs, challenge, brainstorm, decision-map, sharpen
├── references/domains/ # optional stubs + contribution README
└── templates/ # round.md, decision-map.md, context.md, design-brief.mdTemplates: round.md, decision-map.md, context.md, design-brief.md.
Old skill name
| Old | Use |
grill-with-docs | This skill, usually grill-docs |
Related skills
codebase-learner: questions need facts about the current system.second-opinion: the artifact is code or a diff, not a plan.ready-spec: the settled design is a backend or API change that needs a full spec.super-tech-blueprint: the open question is which stack to pick.write-plan: the grilled design is settled and needs a plan.create-tickets: the plan is settled and needs tickets.safe-refactor: the plan is a refactor.design-system-kit: the design under review is a UI or a design system.handoff: save open questions for the next session.
Done when
- The matching mode ran; only needed references were loaded.
- Every asked question had a number and a recommended answer; the user made the decisions.
- Facts cited a file, doc, or "unknown — looked, not found."
- Shared understanding is written (answers, glossary/ADR updates if grill-docs, a decision map if they asked, or an approved design brief after brainstorm).
- No implementation-plan file, refactor, or invented stack unless they explicitly asked for that handoff.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

