agentleFS
pahlevikunpahlevikun/levistack/skills/knowledge/challenge-me/SKILL.md

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

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
  1. Distinctive:

    Facts vs decisions: Look up what the repo or docs already answer.

    line 37
  2. Distinctive:

    Numbered question + recommended answer, then wait: Never dump an interrogation without a rec.

    line 38
  3. Distinctive:

    Past the first three: Do not stop at the obvious answers.

    line 40
  4. Very specific:

    Stop at shared understanding: Do not execute a refactor, invent a stack, or write docs/superpowers/plans/*.md unless the user asks.

    line 41
  5. Distinctive:

    Do this first; do not announce it.

    line 47
  6. Very specific:

    Do not absorb do / make-plan orchestrators.

    line 86
  7. Distinctive:

    Every asked question had a number and a recommended answer.

    line 122
  8. Distinctive:

    No implementation-plan file, refactor, or invented stack unless they explicitly asked for that handoff.

    line 125

“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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. Facts vs decisions. Look up what the repo or docs already answer. Only the user decides trade-offs. See facts-vs-decisions.md.
  2. 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.
  3. Attack the work, not the person. Intensity is a dial. Thermonuclear is off unless they opt in (intensity.md).
  4. 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.
  5. Stop at shared understanding. Do not execute a refactor, invent a stack, or write docs/superpowers/plans/*.md unless the user asks. Then hand off (peers below).
  6. Language-agnostic. The round format works in any language; do not load a second language pack.
  7. 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…ModeLoad
Walk a design tree, grill me, stress-test this plan/idea/architecturegrillgrill.md
Grill against CONTEXT.md, glossary, ADRs, existing docsgrill-docsgrill-docs.md
Blunt advisor: estimates, hidden work, overcomplicationchallengechallenge.md
Ideas → design before implementation (new or existing product)brainstormbrainstorm.md
Compact stateful map across sessions, or work too big for one sessiondecision-mapdecision-map.md
Make a task or prompt deeper before work starts, then rewrite itsharpensharpen.md
Softer/harder, one-at-a-time vs frontier-roundcalibrateintensity.md
Mermaid/PlantUML as an aid, not a diagram takeovermindmapmindmap.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.

SubjectStub
Product / marketplace / new vs existing offeringproduct.md
Engineering / architecture / APIsengineering.md
UI, UX, visual designdesign-ui.md
Prose, specs, narrative docswriting.md

Peers (do not duplicate)

JobSkill
Current-repo facts, smells, ARCHITECTURE.mdcodebase-learner (diagnose pairs with grill-docs)
Target stack / migration blueprintsuper-tech-blueprint — do not invent stacks here
Execute a refactorsafe-refactor
Write the implementation-plan filewrite-plan
Pause/resume the sessionhandoff
Tickets after grillingcreate-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.md

Templates: round.md, decision-map.md, context.md, design-brief.md.

Old skill name

OldUse
grill-with-docsThis 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.