writing-user-stories — скилл для Claude Code: формат user stories
Скилл writing-user-stories для Claude Code помогает агентам писать user stories по правильному формату. Запускается, когда нужно сформулировать требование через призму пользователя — его роль, действие и выгода.
MIT 1 установок ★ 296 обновлён 2026-01-20
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-codeЧто делает writing-user-stories
User stories — это формализованный способ описать требование к функции. Скилл учит агента выделять три компонента: кто это делает (персона), что именно делать (действие) и зачем (выгода). Формула проста: «As a PERSONA I want to DESCRIPTION_OF_ACTION So that DESCRIPTION_OF_BENEFIT».
Скилл работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Подходит, когда вы планируете фичу, уточняете требования или просите агента написать стартовый набор историй для проекта. Агент на основе этого скилла лучше разбирает, что на самом деле нужно пользователю, а не только что технически реализовать.
Установка зависит от платформы: для Claude Code используй npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code, для GitHub Copilot — gh skill install nicepkg/ai-workflow writing-user-stories. После установки скилл загружается в рабочий контекст агента и срабатывает на запрос о user stories.
Какие задачи решает
- Сформулировать требование через потребности пользователя, а не технические детали
- Написать user stories для новой фичи или эпика
- Убедиться, что историю можно проверить и оценить в конце спринта
Примеры запросов агенту
- Напиши user stories для функции экспорта отчётов в PDF
- Помоги спланировать фичу user stories — используй writing-user-stories скилл
- Преобразуй эту техническую спецификацию в набор user stories
Как установить writing-user-stories
1Через Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code2Вручную: положить файлы
~/.claude/skills/writing-user-stories/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/writing-user-stories/
1Через Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a codex2Вручную: положить файлы
.agents/skills/writing-user-stories/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a cursor2Вручную: положить файлы
.cursor/skills/writing-user-stories/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install nicepkg/ai-workflow workflows/product-manager-workflow/.claude/skills/writing-user-stories2Вручную: положить файлы
.github/skills/writing-user-stories/SKILL.md1Через Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a gemini-cli2Командой платформы
gemini skills install https://github.com/nicepkg/ai-workflow --path workflows/product-manager-workflow/.claude/skills/writing-user-storiesВручную: положить файлы
.devin/skills/writing-user-stories/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о writing-user-stories
Как установить writing-user-stories в Claude Code?
Выполни команду npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code. Скилл загрузится в директорию ~/.claude/skills/writing-user-stories/SKILL.md и будет доступен агенту при следующем запуске.
Что делает writing-user-stories?
Учит агента писать user stories по стандартному формату: как персона хочет выполнить действие, чтобы получить результат. Это помогает чётче определить требования к фичам и упрощает планирование разработки.
На каких платформах работает writing-user-stories?
На Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Установка отличается для каждой: для Claude Code — npx skills add, для GitHub Copilot — gh skill install.
Исходный текст
SKILL.md · MIT
--- name: writing-user-stories description: Use when an agent needs to write user stories for a project --- # Writing User Stories ## Overview Help Claude and subagents write properly formatted user stories for task definition. **Core principle:** User stories are formulaic ways of expressing user requirements. They identify the perosna of the actor, what they want to do, and what benefit are they hoping to gain from their actions. ## When to Use This Skill Use this skill when: - You are asked to write a user story - You are asked to plan a feature ## User Story Format As a PERSONA I want to DESCRIPTION_OF_ACTION So that DESCRIPTION_OF_BENEFIT. ### Examples As a non-technical stakeholder, I want to understand what changed in a release without reading code diffs so that I can communicate updates to customers effectively. As a new user, I want to see examples of AI-generated code before connecting my repository so that I understand the value proposition before committing to integration. As a home cook, I want to see that recipes have been tested by professional chefs so that I can know whether they are worth trying.
© nicepkg · MIT · nicepkg/ai-workflow