Product discovery
align
Check whether the product still fits its goals and users and what the outcome evidence shows; read-only.
Say “check alignment”
Product discovery · Portable skill
Investigate a question or a competitive landscape from sources and record a dated, sourced note another session can decide from.
npx skills add gaboesquivel/flow-skills -s researchNatural language is the interface. Any of these, or your own words, reach the skill.
A sourced note answering the question, or a competitive brief for "competitors for X": the decision it serves, findings marked observed, claimed, or inferred, limits, and implications, updating a current note instead of duplicating it.
The authoritative, versioned instruction your agent follows, from skills/research/SKILL.md.
"Research X" answers a question from evidence and leaves a note someone who missed the conversation can decide from; "competitors for X" is the same job as a competitive brief. The request authorizes the note.
Start from the decision the research serves; infer it and say so when unnamed. Read the project context it touches and existing notes first: update a current note on the same question rather than duplicating it, keeping superseded findings readable with their dates. Then look externally, preferring primary sources (official docs, repositories, the product itself).
For a competitive brief, establish the intended user, the job they are doing, and the realistic substitutes: the status quo or a manual workaround, direct products, and open-source tools, host features, APIs, or integrations. Compare only distinctions that could change the choice, in a table when it is a genuine comparison; no generic feature matrix or exhaustive list.
PRODUCT.md, or starts setup or delivery; name the skill that would (explore, sync-docs, to-spec) and stop.Use the project's research convention (Flow Skills: docs/research/, indexed in docs/references.md); without one, write a single docs/research/YYYY-MM-DD-topic.md and no index, taxonomy, or tree. As short as complete:
Write only the note and an existing index, on a non-default branch (the current one, else one named for the research; write-agents Sessions); commit and report the path as a link, opening it where the host supports that.
Product discovery
Check whether the product still fits its goals and users and what the outcome evidence shows; read-only.
Say “check alignment”