Shape User Idea
Comes after review, beside the backlog. The user already has an
idea, a question, or an artifact. This skill writes
journal/ideas/<slug>.md and one Ideas row only after they
confirm. The backlog triages that file later.
Human-facing prose
Details: setup-workspace references/human_facing_prose.md.
Questions and the confirmation paragraph describe this idea in
data-science terms — not skill ids or the wrapper CLI.
Procedure
- Run
python -m skore_skills status. Read journal/JOURNAL.md
Status and History, and data_analysis/data_analysis.md when it
exists.
- If the entry is not already a concrete idea, question, or
artifact, AskUserQuestion: free-text or artifact. A URL,
issue, path, or stated idea skips that menu.
- A question about this project is answered from those files.
Leave an unknown metric as
n/a. Write no idea file and
return to the caller.
- A topic with no artifact ("what do people do for …") loads
search-ml-literature only if
status.skills.search-ml-literature is true. Otherwise
one-line skip. Do not WebSearch for a paper from here.
- An artifact is read, not reconstructed. Paper or doc URL:
WebFetch the page. GitHub issue: gh auth status first;
if unauthenticated, ask the user to run gh auth login or
paste the body. Then gh issue view. Resolution: explicit
URL, then org/repo#N, then bare #N only in the current
gh repo — otherwise ask. Spec or notes file: read that
file only.
- Walk three questions. Do not fabricate a missing answer.
- What are we trying to learn?
- Why now? Quote the user or the artifact.
- What changes versus the last experiment, in prose?
- If the idea changes the project goal in
journal/JOURNAL.md
Status, ask before writing the file. A library the source names and
the user has not agreed to add stays in Open gaps. A domain
claim this dataset does not establish stays in Open gaps.
- Restate the idea in one short paragraph, then one
single-choice AskUserQuestion: Yes / No. Do not
also ask for a typed yes. Put that question in the message
before any idea file. "Maybe" is not Yes. No or Stop writes
nothing. A Yes from the tool, or an explicit yes the user
already gave, authorizes the write only after that question
is in the message.
- On Yes, write
journal/ideas/<slug>.md and upsert its Ideas
row. Do not create a design note. Do not edit History,
Backlog, or Status. Write journal/ideas/<slug>.md:
# <slug>
- Experiment: <last History stem, or n/a>
- Source: user
- Triage: open
- Question:
- Why now:
- What changes:
- Open gaps:
Why now carries the quote, URL, or path. No acceptance
criteria. Then upsert one ## Ideas row: Question as plain
text, Status open, Experiment <last History stem, or n/a>,
Source user. If that table is missing, insert it between
History and Backlog. Do not rewrite the other sections.
Return the path to the caller (manage-ml-backlog or
triage-ml-task).
Stop conditions
- Do not write History, Backlog, Status, or a design note.
The Ideas table is the only
JOURNAL.md edit.
- Do not append a
B<N> row. The backlog triages the file.
- Do not invent source content from a title.
- Do not
WebSearch for a topic with no artifact.
- The entry question and the Yes / No confirmation are
required gates.
- If the user already asked to add a named library, put it in
What changes and load
add-python-package when that skill
is installed. Do not pixi add from here.
1---2name: shape-user-idea3description: >4 Shape a user idea or a named artifact into one idea file and one Ideas row5 after they confirm. A topic with no artifact belongs to6 search-ml-literature. Do not write History, Backlog, or a design note. Do7 not pick a backlog row.8metadata:9 source: https://skillmd.com/skills/probabl-ai/shape-user-idea10 role: helper11 modelTier: medium12---1314# Shape User Idea1516Comes after review, beside the backlog. The user already has an17idea, a question, or an artifact. This skill writes18`journal/ideas/<slug>.md` and one Ideas row only after they19confirm. The backlog triages that file later.2021## Human-facing prose2223Details: `setup-workspace` `references/human_facing_prose.md`.24Questions and the confirmation paragraph describe this idea in25data-science terms — not skill ids or the wrapper CLI.2627## Procedure28291. Run `python -m skore_skills status`. Read `journal/JOURNAL.md`30 Status and History, and `data_analysis/data_analysis.md` when it31 exists.322. If the entry is not already a concrete idea, question, or33 artifact, **AskUserQuestion**: free-text or artifact. A URL,34 issue, path, or stated idea skips that menu.353. A question about this project is answered from those files.36 Leave an unknown metric as `n/a`. Write no idea file and37 return to the caller.384. A topic with no artifact ("what do people do for …") loads39 `search-ml-literature` only if40 `status.skills.search-ml-literature` is true. Otherwise41 one-line skip. Do not `WebSearch` for a paper from here.425. An artifact is read, not reconstructed. Paper or doc URL:43 `WebFetch` the page. GitHub issue: `gh auth status` first;44 if unauthenticated, ask the user to run `gh auth login` or45 paste the body. Then `gh issue view`. Resolution: explicit46 URL, then `org/repo#N`, then bare `#N` only in the current47 `gh` repo — otherwise ask. Spec or notes file: read that48 file only.496. Walk three questions. Do not fabricate a missing answer.50 - What are we trying to learn?51 - Why now? Quote the user or the artifact.52 - What changes versus the last experiment, in prose?537. If the idea changes the project goal in `journal/JOURNAL.md`54 Status, ask before writing the file. A library the source names and55 the user has not agreed to add stays in Open gaps. A domain56 claim this dataset does not establish stays in Open gaps.578. Restate the idea in one short paragraph, then one58 single-choice **AskUserQuestion**: **Yes** / **No**. Do not59 also ask for a typed yes. Put that question in the message60 before any idea file. "Maybe" is not Yes. No or Stop writes61 nothing. A Yes from the tool, or an explicit yes the user62 already gave, authorizes the write only after that question63 is in the message.649. On Yes, write `journal/ideas/<slug>.md` and upsert its Ideas65 row. Do not create a design note. Do not edit History,66 Backlog, or Status. Write `journal/ideas/<slug>.md`:6768```69# <slug>70- Experiment: <last History stem, or n/a>71- Source: user72- Triage: open73- Question:74- Why now:75- What changes:76- Open gaps:77```7879 Why now carries the quote, URL, or path. No acceptance80 criteria. Then upsert one `## Ideas` row: Question as plain81 text, Status `open`, Experiment `<last History stem, or n/a>`,82 Source `user`. If that table is missing, insert it between83 History and Backlog. Do not rewrite the other sections.84 Return the path to the caller (`manage-ml-backlog` or85 `triage-ml-task`).8687## Stop conditions8889- Do not write History, Backlog, Status, or a design note.90 The Ideas table is the only `JOURNAL.md` edit.91- Do not append a `B<N>` row. The backlog triages the file.92- Do not invent source content from a title.93- Do not `WebSearch` for a topic with no artifact.94- The entry question and the Yes / No confirmation are95 required gates.96- If the user already asked to add a named library, put it in97 What changes and load `add-python-package` when that skill98 is installed. Do not `pixi add` from here.