path-to-goal
Skill0 starsChanged 5 months agoMITView on GitHub
Use to clarify decisions or provide status updates in a goal-focused culture of rapid, evidence-based technical and strategic decision-making. Alias unconfuse-me.
In this repository3 other files it gives its agents.
- obsidian-html-docsSkill
- social-researchSkill
- token-countSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 5 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
If there are no decisions to make, say so clearly.
- Distinctive: line 16
If there are decisions to make, remind the user of shorthand options they can respond with:
- Distinctive: line 27
Never write "ELI10" but write all text in ELI10
- Distinctive: line 34
If an option includes "I" or "you" the decision question must make it clear that "you" refers to the user e.g.
- Distinctive: line 36
No other emojis or icons
- Very specific: line 42
If user responds q, it means launch your built-in tool for collecting user input, like AskUserQuestion or request_user_input or similar to …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Path to goal
With ELI10 clarity, summarize:
- goal, one sentence
- current status, 1-3 need to know sentences
- in a new section, numbered path to goal from the start with ✅ or ⬜, including each numbered decision in its step when it becomes blocking
- in a new section, all the numbered decisions you need from me to move forward, as well-articulated one-line questions in bold followed by a table of lettered options in order to enable shorthand responses like
1a 2c 3b. Highlight your recommended options with★. - If there are no decisions to make, say so clearly.
If there are decisions to make, remind the user of shorthand options they can respond with:
lgtmaccepts ★1a 2b 3bto choose (exclude if single decision)1?request more detail and confidence on decision 1 before decidingqlaunch built-in tool for user input (exclude if no tool)
Readability
The value of this skill is condensing a lot of complex information into a form that is fast and efficient for a human to understand and respond to, so following these rules is important to achieve this.
- Never write "ELI10" but write all text in ELI10
- One liner items are < 88 chars
- Exempt from the char budgets are the anchor words required to correctly ask the decision to the user in the most effective way "Will I..." or "What is the next step for..." or "You need to decide on...".
- Decisions are always numbered, preceded by a blank line, and followed by a <64 char ELI8 subtitle of why it's important (prefix " - Why: "), then an optional " - Link: " only when a canonical URL (a github.com PR) lets the user make the decision.
- For the table of options use ( # | Option | Tradeoffs) and for each tradeoff, prefix bolded symbols
(+)for beneficial,(-)for negative,(+/-)if both good and bad, and increase count(++)sparingly only for notable differences (e.g. >1-2 orders of magnitude). Order a cell's tradeoffs descending, most positive(++)first down to most negative(--). - Negligible tradeoffs are not listed.
- Differences in difficulty or effort for agent or wall clock time are out of scope as tradeoffs.
- If an option includes "I" or "you" the decision question must make it clear that "you" refers to the user e.g. "I (agent) will..."
- Prefix your path-to-goal response with a separator block — so the user can instantly spot where the report starts — then continue with the normal summary. The token-efficient block is a centered 1-col table, first row a line of
·(middot) repeated to span one visual row — best-effort viewport width, default 80 if unknown. Second row title:PATH · TO · GOAL. Then a blank line, and the summary begins (**Goal:** ...). - No other emojis or icons
Shorthand responses
Expanded instructions for some shorthand responses:
- If user responds
q, it means launch your built-in tool for collecting user input, likeAskUserQuestionorrequest_user_inputor similar to collect user responses to each of these decisions. Follow the same decision numbers and formatting as closely as your built-in tool allows. - If user responds
1?it means "I can't decide on Decision 1 with the provided level of info. Follow up with the next level of detail and 3x char budgets and revisit this decision singularly next. Do not consume chars on duplicative points, focus on providing the single best description of each point once."
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.

