ask-me
Skill12 starsChanged 2 months agoMITView on GitHub
Turn the current plan into a numbered list of what only the human can supply — decisions, facts only they know, credentials or access, data from systems the agent can't reach, and real-world or interactive actions — each with why the agent is blocked, which step it unblocks, the default if unanswered, and the exact reply shape. Works only from what is already in context; calls no tools and never explores the codebase. Use when the user asks what you need from me, what's blocked on me, give me my part, what are your questions, or says ask me what you need, or invokes ask-me; and proactively once the plan reaches a step that depends on a person.
15 other projects use a version of this.
Adopted by
Most recently taken up by
- allemaar/open-skillstheir own version, first seen Nov 8, 2026
- catesandrew/skillstheir own version, first seen Nov 1, 2026
- TanKaizokuO/claude-skillstheir own version, first seen Oct 20, 2026
- grinbuddy/claude-skillstheir own version, first seen Oct 17, 2026
- master-g/skillstheir own version, first seen Oct 13, 2026
- nhhthong/skillstheir own version, first seen Oct 13, 2026
Used with
Projects with it also use handoff.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
MicrosoftSkillhandoff
Compact the current conversation into a handoff document for another agent to pick up.
Also in 4 projects that use this
Other versions15 projects use a version of this.
Word for word · 1
- ivklgn/bag-of-skills★ 12100% same
Edited · 0
None found.
Wrote their own version · 14
- allemaar/open-skills★ 15same name
- cassianodiniz/cass★ 4same name
- cassianodiniz/Titan★ 4same name
- Chrisamansood/chris-ai-productivity★ 2same name
- catesandrew/skills★ 1same name
- DanaResearchGroup/agent-skills★ 1same name
- himadajin/skills★ 1same name
- madanlalit/agentskills★ 1same name
- nhhthong/skills★ 1same name
- grinbuddy/claude-skills★ 0same name
4 more not listed
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 repository22 other files it gives its agents.
- AGENTS.mdAGENTS.md
- new-skillSkill
- review-and-releaseSkill
- 12-factor-appsSkill
- audit-websiteSkill
- can-i-useSkill
- code-reviewerSkill
- compatibility-auditSkill
- explain-branch-changesSkill
- humanizer-ruSkill
- humanizerSkill
- jsdocSkill
- load-branch-changesSkill
- nextjs-developerSkill
- recapSkill
- reset-permissionsSkill
- review-golangSkill
- seo-auditSkill
- simplify-code-commentsSkill
- test-health-checkSkill
- update-golang-depsSkill
- update-node-depsSkill
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 10 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 77
Every item traces to something in the session: a failed attempt, a declined call, a stated gap, a fork in the plan.
“Common” is measured: kept by at least 6 in 10 of the 10 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
Ask Me
Produce a list the human can work through without re-reading the session — every line on it must be something only they can do.
Speed contract
Call no tools. Everything needed is in context: the goal, the plan, what was tried, what failed, what the user already said. Never Read, Grep, Glob, search, or launch a subagent to "check whether it's really needed" — if the session does not show the limit, the item does not exist yet.
Language
Write in the language the user has been writing in this session, not the language of this skill. Mixed input follows the dominant language of the user's own messages. Translate the kind tags and labels — tags in Russian: Решить / Ответить / Доступ / Принести / Сделать; item labels: Причина (why me not you) / Блокирует / По умолчанию / Ответ; closing line: Пока жду. Keep identifiers verbatim — paths, commands, hostnames, branch names, error text.
What qualifies
An item earns its place only when the session shows the agent genuinely cannot do it. Five kinds:
| Tag | The item is… | Typical sign in the session |
| Decide | a choice the user owns: product behaviour, scope, priority, spending, anything irreversible | two valid approaches, and picking one changes the work |
| Answer | a fact only the user has: intended behaviour, what production does, what a colleague agreed | the agent guessed, or asked and got no reply |
| Access | a credential, permission, VPN, MCP server that failed to connect, a tool call the user declined | an auth error, "server failed to connect", a denied permission |
| Fetch | data in a system the agent cannot reach: dashboard, email, chat thread, ticket, remote log, closed database | the plan needs a number or a file the session never contained |
| Do | an action in the world or in an interactive session: approve, merge, pass 2FA, run an interactive login, restart a box, look at a screen | the next step is a click, a signature, or ! <command> |
Not an item:
- anything the agent can read, run, search, or try itself but simply hasn't yet — untried capability is never an item; only a failure already in the session earns one
- anything already answered earlier in the session, including inside a compacted summary
- anything a reasonable default resolves cheaply and reversibly — apply it, mention it in the closing line, skip the item (costly-to-reverse choices are Decide items instead — list them, defaulted)
- a repeat of a tool call the user already declined — that becomes one Access item asking whether to retry differently, never the same call again
Item format
Numbered. Blocking items first, in plan order; non-blocking ones after. Each item, in this order:
- Tag + ask — one line, actionable without context. Closed questions with options beat open ones; one ask per item, split compound requests, merge asks that one action resolves.
- Why me not you — the concrete limit in one clause:
no ssh to prod from here,tool call declined,needs a product call. Never a bare "I can't". - Blocks — the plan step(s) it gates, or
nothing — speeds up step N. - Default — what happens if unanswered. For Decide, that default is the agent's recommendation.
- Reply — the exact shape: a word, a number, a pasted output, a path, yes/no.
N. [Tag] <the ask, one line>
Why me not you: <the concrete limit>
Blocks: <step(s) it gates, or "nothing — speeds up step N">
Default: <what happens if unanswered>
Reply: <exact expected shape>Close with two lines:
- Meanwhile: what the agent does now that needs none of the above — or
nothing, everything waits on 1. - one hint: reply by number; unanswered items take their default.
Hard limits: at most 8 items. More than that — keep the 8 blocking the most steps (ties: the earliest step), group the rest by where they'd be resolved (same system, same person) into one line, and say how many were folded. No preamble (not "Вот что мне нужно от тебя:"), no apology, no restating the plan.
Argument
Empty → the full list. A plan step number or name, or a topic word → only items for that — numbers mean plan steps, never the list's own item numbers, which exist only for replying. blocking → only items that gate a step. An argument that matches nothing → say so and name the steps that do have items — never guess.
Edge cases
- Nothing needed — one line: nothing needed, plus the next step the agent is taking.
- No plan in context — build the list from the goal. If the goal itself is unclear, that is item 1 and the only item.
- Compacted context — work from the summary as-is. If it records a question asked but not answered, the item goes back on the list with a note that it was asked before.
- Two or more unrelated tasks — build the list for the current task only.
- Fewer than three exchanges — skip the template, ask in one line.
Accuracy
Every item traces to something in the session: a failed attempt, a declined call, a stated gap, a fork in the plan. Nothing from general caution, nothing "just in case". A list with one real item beats a list with five plausible ones.
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.

