ask-to-plan SKILL.md skillA

ask-to-plan from scarletkc/agents is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add scarletkc/agents/ask-to-plan@git:20260912.38254d6

Pins git:20260912.38254d6 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
scarletkc/agents
Path
skills/ask-to-plan/SKILL.md
Versions recorded
1
Latest version
git:20260912.38254d6, committed Sep 12, 2026
Size
9,792 bytes
Repository stars
227
License
Apache-2.0

Guide a user from an unclear idea to an actionable plan through the agent harness's native ask tool and clickable choices. Use when the user wants a guided requirements interview, step-by-step questions, help deciding what to build, or a button-led path from goals to scope, solution, and technology choices. Do not turn an ordinary implementation request or a single clarification into an interview.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Ask to Plan

Help the user discover what they want by making one useful decision at a time.
Move from broad outcomes to concrete requirements and then an implementable
plan. The user should be able to make progress by choosing buttons, including
when they have no idea yet or do not know technical terms.

The default deliverable is a plan. Starting this interview or accepting a
solution does not itself request implementation. If the user later asks to
build it, carry the settled requirements into that work.

## Use the harness's actual ask tool

Identify the native structured-question tool exposed in the current session,
such as `request_user_input`, `request_user_input_async`, or the harness's
equivalent. Use the tool to present choices. Follow its actual schema and
current mode restrictions, including question limits, option limits, and
whether the interface already supplies free-text input or an Other option.
Tool names here are discovery hints, not a promise that a tool is available.

Start with a brief explanation of the next decision and one native question.
Do not print a questionnaire, simulate buttons in Markdown, or produce a
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add scarletkc/agents/ask-to-plan@sha256:3c8198aaf1a8b64f

The line at the top of this page pins the label git:20260912.38254d6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_k5mzylq7cpdsdcub.svg)](https://markdownregistry.com/a/art_k5mzylq7cpdsdcub)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 12, 2026.

versioncommittedcommitsizeaudit
git:20260912.38254d6 latest2026-09-12 38254d6 9,792 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9792 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

scarletkc/agents · 227 stars · license Apache-2.0 · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_k5mzylq7cpdsdcub
GET https://markdownregistry.com/api/v1/resolve?ref=scarletkc/agents/ask-to-plan
GET https://markdownregistry.com/api/v1/blob/3c8198aaf1a8b64fb3bd76ff82821308a075b86bd21e548d3556c2a679eacd77

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from scarletkc/agents

AGENTS.md AGENTS.md file
scarletkc/agents · AGENTS.md
git:20260729.8b4c64c · audit A · 227 stars
CLAUDE.md CLAUDE.md file
scarletkc/agents · CLAUDE.md
git:20260712.c889f7d · audit B · 227 stars
antigravity-cli SKILL.md skill
scarletkc/agents · skills/antigravity-cli/SKILL.md · Delegate bounded investigation, review, or implementation tasks to Antigravity CLI from a supervising agent. Includes a…
git:20260911.6bd4c6a · audit B · 227 stars
codex-cli SKILL.md skill
scarletkc/agents · skills/codex-cli/SKILL.md · When handing work to the Codex CLI earns its cost, and how to size the run: second-model review, bounded implementation…
git:20260824.d5a3123 · audit A · 227 stars
devin-cli SKILL.md skill
scarletkc/agents · skills/devin-cli/SKILL.md · Delegate bounded coding tasks to the local Devin CLI over ACP from a supervising agent such as Claude Code or Codex…
git:20261018.2e55254 · audit B · 227 stars
grok-cli SKILL.md skill
scarletkc/agents · skills/grok-cli/SKILL.md · Delegate bounded tasks to Grok Build from a supervising agent such as Codex. Use when the user asks Grok to…
git:20260911.0fe4be4 · audit B · 227 stars
marketing-copy SKILL.md skill
scarletkc/agents · skills/marketing-copy/SKILL.md · Write outbound promotional copy for a product or project: launch and update posts for community platforms and social…
git:20260824.d5a3123 · audit A · 227 stars
product-writing SKILL.md skill
scarletkc/agents · skills/product-writing/SKILL.md · Write, edit, or review UI copy, CLI messages, help text, code comments, and technical documentation covering product…
git:20260907.7531b02 · audit A · 227 stars
scoped-change SKILL.md skill
scarletkc/agents · skills/scoped-change/SKILL.md · Judgment rules for locating the correct boundary of a requested change: staying inert outside it while completing every…
git:20260824.d5a3123 · audit A · 227 stars
talk-like-scarletkc SKILL.md skill
scarletkc/agents · skills/talk-like-scarletkc/SKILL.md · 按 scarletkc 本人的自然表达习惯代写、改写、润色和翻译文本,适用于推文、评论、聊天消息、模型或工具体验文、项目介绍、GitHub 文本和正式通信。用户要求撰写可直接使用的成稿、去除 AI…
git:20261021.3be29ae · audit A · 227 stars
ux-writing SKILL.md skill
scarletkc/agents · skills/ux-writing/SKILL.md · Judgment for text read by someone who wasn't there when it was written: user-facing output, error and help text, docs…
git:20261102.8e149b3 · audit A · 227 stars
worktree-pr SKILL.md skill
scarletkc/agents · skills/worktree-pr/SKILL.md · Decide whether a task deserves its own git worktree and, if chosen, run it end to end: branch from the integration…
git:20260824.d5a3123 · audit A · 227 stars

Every file in scarletkc/agents

Browse by kind, by grade A, or by owner.