intake
/intake
Turn a raw stakeholder or client request into reviewable requirements: context, user stories, acceptance criteria, out-of-scope list, open questions, and the person who must answer each one. Use when a request arrives as a chat message, a meeting note, a mail, a one-line ticket, or a Figma design, and the team cannot start work from it yet. Triggers on: "intake", "requirement", "làm rõ yêu cầu", "phân tích yêu cầu", "user story", "acceptance criteria", "要件定義", "要求整理", "clarify this request", "turn this into stories", "requirement from Figma", "stories from this design", "phân tích yêu cầu từ F
- Author
- lamngockhuong ↗
- Repository
- aiteamkit ↗
- Licence
- MIT
- Last repository change
- 24.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 24.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Turn a raw stakeholder or client request into reviewable requirements: context, user stories, acceptance criteria, out-of-scope list, open questions, and the person who must answer each one. Use when a request arrives as a chat message, a meeting note, a mail, a one-line ticket, or a Figma design, and the team cannot start work from it yet. Triggers on: "intake", "requirement", "làm rõ yêu cầu", "phân tích yêu cầu", "user story", "acceptance criteria", "要件定義", "要求整理", "clarify this request", "turn this into stories", "requirement from Figma", "stories from this design", "phân tích yêu cầu từ F
Triggers from the description
Arguments
/intake [request-file|ticket-id|text] [--design <figma-url|image-dir>] [--interview|--no-interview] [--lang <code>] [--out <path
Original author description
Turn a raw stakeholder or client request into reviewable requirements: context, user stories, acceptance criteria, out-of-scope list, open questions, and the person who must answer each one. Use when a request arrives as a chat message, a meeting note, a mail, a one-line ticket, or a Figma design, and the team cannot start work from it yet. Triggers on: "intake", "requirement", "làm rõ yêu cầu", "phân tích yêu cầu", "user story", "acceptance criteria", "要件定義", "要求整理", "clarify this request", "turn this into stories", "requirement from Figma", "stories from this design", "phân tích yêu cầu từ F
How it works
- Scope
- Roles
- Invocation
- Workflow
- Output
- Ticket
- Definition of done
SKILL.md preview
---
name: intake
description: >
Turn a raw stakeholder or client request into reviewable requirements: context, user stories,
acceptance criteria, out-of-scope list, open questions, and the person who must answer each one.
Use when a request arrives as a chat message, a meeting note, a mail, a one-line ticket, or a
Figma design, and the team cannot start work from it yet.
Triggers on: "intake", "requirement", "làm rõ yêu cầu", "phân tích yêu cầu", "user story",
"acceptance criteria", "要件定義", "要求整理", "clarify this request", "turn this into stories",
"requirement from Figma", "stories from this design", "phân tích yêu cầu từ Figma",
"Figmaから要件定義", "/atk:intake".
argument-hint: "[request-file|ticket-id|text] [--design <figma-url|image-dir>] [--interview|--no-interview] [--lang <code>] [--out <path>]"
---
# Requirement Intake (`atk:intake`)
Converts an unstructured request into a requirement artifact that a Dev can estimate, a QA can
test, and a stakeholder can approve. The output records what was asked, what was assumed, and what
is still unanswered, with a name against every open question.
## Scope
Handles: reading the raw request, including a Figma design or the images exported from it, scanning the codebase for what already exists, splitting the
request into user stories, writing testable acceptance criteria, listing non-goals, and collecting
open questions with an owner each.
Does NOT handle: estimating effort (`atk:estimate`), technical design (`atk:design-doc`), task
assignment (`atk:breakdown`), writing a screen's component table (`atk:spec --kind screen`), or
deciding priority and scope. Those belong to the PM and the
stakeholder; this skill records their decision, it does not make it.
Nor explaining a document a person was handed so they can understand it, a vendor's report or a
client's specification read rather than turned into requirements, which is `atk:catchup`.
## Roles
PM and BrSE/BA lead. Tech Lead reviews feasibility. QA reviews whether each acceptance criterion is
testable. See `shared/team-roles.md`.
## Invocation
```bash
/atk:intake <request-file> # Read a meeting note, mail export, or spec fragment
/atk:intake "<pasted request>" # Read the request straight from the prompt
/atk:intake <ticket-id> # Pull the request from the detected tracker
/atk:intake --design <figma-url> # Read a Figma frame or section as the request, alone or beside any of the above
/atk:intake --design <image-dir> # The same from exported images, where Figma is out of reach
/atk:intake --no-interview # Draft from the request alone, mark every gap OPEN
/atk:intake --lang ja # Write the artifact in Japanese
/atk:intake --out <path> # Override the default output path
```
## Workflow
```
[1. Read request] -> [2. Scan repo] -> [3. Interview gaps] -> [4. Draft stories] -> [5. Review gate]
```
Before step 1, read `.atk/overrides/intake.md` when it exists, per rule 7 of `shared/team-roles.md`.
Then, before anything else, create this run's trace, `<docs root>/derived/traces/intake/<run-id>.md`:
read the kit's `shared/run-trace.md` and do what it says before the file, at each step, and at the close.
### 1. Read the request
Quote the request verbatim into the artifact before interpreting it. Interpretation drifts; the
quote does not.
A design given with `--design` is read per `shared/design-sources.md`, which applies the connection
states of `shared/host-capabilities.md` to Figma and holds the fallback to exported images. A picture cannot be quoted the way text
can, so in place of the quote the artifact records what was read: the source, in the form What a read records in
`shared/design-sources.md` gives it, each frame with its
`screen_id`, node ID and fingerprint, and the date. The line saying that Ready for dev could not be
checked goes with it, in the artifact and in the session. Where the design cannot be read and the
request also came as text or a ticket, the run carries on from those and records which state of the
connection kept the design out; under `--no-interview` any question the reading raises is marked
`OPEN` rather than asked.
### 2. Scan the repository
Find what already exists: matching features, similar endpoints, existing entities, prior
requirement docs, and the screen and feature specs under `docs/screens/` and `docs/features/`, which
say what an existing screen already shows and does. A request is often a change to something, not a new thing. Cite file paths.
### 3. Interview the gaps
Ask only what neither the request nor the repository answers, one question at a time, with two to
four concrete options and a recommendation. Stop at the first material answer per topic. Skip this
step under `--no-interview` and mark each gap `OPEN` with a suggested owner.
### 4. Draft stories and criteria
One story per user-visible outcome. From a design, each behaviour the user can see on it is a
candidate story: a control that does something, a transition, a message. What the design does not
show, a limit, a rule, what happens on failure, is never read into it: it is proposed or asked, per
What the design does not show in `shared/design-sources.md`.
Acceptance criteria are `Given / When / Then` and each one must
be checkable by a person who did not write it. Vague criteria such as "works correctly" or "is fast"
are rejected: replace them with a number, a state, or a visible result, or move them to open
questions.
Write the artifact in the shape `references/requirement-template.md` fixes: the story sentence, the
`AC N.M` IDs that later skills cite, and the columns of the open-questions table.
### 5. Review gate
Set `status: IN REVIEW` and name the approver. Do not mark anything `APPROVED` on the team's behalf.
## Output
Written to `docs/records/requirements/<date>-<ticket>-<slug>.md` per `shared/artifact-paths.md`.
From a design, the screen's component table is the next artifact, and `atk:spec --kind screen`
writes it. Sections:
front matter, original request, context and current behavior, user stories with acceptance criteria,
out of scope, assumptions, open questions with owners, and impacted areas with file paths. The
headings, their order, and the shape of each section are in `references/requirement-template.md`.
Putting it where the team can see it is `atk:git`, which follows the artifact section of
`shared/finalize-steps.md`: the branch, the commit, and the judgement about whether this one belongs
in a pull request for its approver to read. Whether it is committed at all is the persistence group
it falls into, per `shared/artifact-paths.md`.
## Ticket
Follow `shared/ticket-adapters.md`. Offer to open one epic plus one issue per story. Show the list
first; create nothing without a yes.
## Definition of done
- [ ] Every story has at least one testable acceptance criterion.
- [ ] Every assumption is labelled as an assumption, not stated as a fact.
- [ ] Every open question names the person who must answer it.
- [ ] The out-of-scope list is non-empty, or its emptiness is explained.
- [ ] Nothing is marked `APPROVED` without the approver actually saying so.
- [ ] A design given as the request is recorded by source, frames, node IDs, fingerprint, and date,
with the Ready for dev line, and nothing it does not show is stated as a criterion unless it is
marked `Proposed:` with its source.
Files in this package (3)
- SKILL.md 7 KB
- evals/trigger_evals.json 3 KB
- references/requirement-template.md 6 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · lamngockhuong/aiteamkit | 100 | MIT |
| skillberry-ai/cap-evolve | 100 | Apache-2.0 |
| alecs5am/ralphy | 100 | Apache-2.0 |
| mathews-tom/armory | 100 | MIT |
| alecs5am/ralphy | 100 | Apache-2.0 |
| buriedsignals/splash | 100 | MIT |
| vanducng/skills | 90 | MIT |
| yuxqiu/loci | 90 | MIT |
| woditschka/agentic-coding-reference | 90 | MIT |
Database snapshot: 13.11.2026 · package version 4abb0bcce10b (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100requirements-linter
Reviews requirements, user stories or specs for quality problems — ambiguous words, missing actors, untestable statements, compound requirements, missing acceptance criteria — and scores each one, then proposes rewrites and clarifying questions. Use when the user asks to review,… - 90requirement-analysis
Turns source requirements into reviewable business rules and acceptance criteria. Invoke when users ask to analyze, clarify, confirm, or revise requirements before technical design. - 100story-author
Turn a raw feature idea, improvement, or bug description into a structured user story with testable acceptance criteria, persisted as a local markdown file. Invoke when the user wants to create, draft, or refine a story, ticket, requirement, or acceptance criteria — trigger… - 100requirements-test-cases
Step 4 of the requirements workflow — turns a requirement and its acceptance criteria into concrete, executable test cases QA can run, and links requirements → stories → tests in a traceability matrix so nothing ships untested. Triggers whenever a user says things like "write… - 100meeting-to-requirements
Turns raw meeting notes, interview transcripts, workshop recordings' transcripts or chat logs with stakeholders into structured requirements — business goals, functional and non-functional requirements, business rules, assumptions, open questions and action items, each traceable… - 95user-stories
Write INVEST-compliant user stories with Given-When-Then acceptance criteria. Use when writing user stories, creating acceptance criteria, or during /design Step 4.