team-workflow — Claude Code skill: what it does, how to install
Designs an operating cadence for design teams, covering task tracking, regular rituals, and developer handoff. Helpful when day-to-day design collaboration lacks structure.
npx skills add Owl-Listener/designer-skills --skill team-workflow -a claude-codeWhat team-workflow does
This skill sets up a design team's operating rhythm across task management, team rituals, communication norms, tool selection, and developer collaboration. It structures work around six sequential phases: discovery, exploration, refinement, developer handoff, visual QA, and post-launch iteration.
The instructions guide the agent to define concrete tracking states, feedback rules, and meeting cadences such as weekly critiques or milestone reviews. If you need a time-boxed framework for a fast sprint, this skill intentionally steps aside: use design-sprint-plan instead.
What it helps with
- Define task statuses, priorities, and boards in Jira or Linear
- Schedule design critique and milestone review rituals
- Standardize developer handoff and visual QA procedures
- Set expectations for sync and async communication channels
Example prompts for the agent
- Set up a weekly design critique format and review checklist for our team
- Define our Figma-to-developer handoff process and design QA steps
- Draft task statuses, priority levels, and async communication norms for Jira
How to install team-workflow
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill team-workflow -a claude-code2Manually: put the files in place
~/.claude/skills/team-workflow/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/team-workflow/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill team-workflow -a codex2Manually: put the files in place
.agents/skills/team-workflow/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill team-workflow -a cursor2Manually: put the files in place
.cursor/skills/team-workflow/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills team-workflow2Manually: put the files in place
.github/skills/team-workflow/SKILL.md1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill team-workflow -a gemini-cli2Platform CLI
gemini skills install https://github.com/Owl-Listener/designer-skills --path design-ops/skills/team-workflowManually: put the files in place
.devin/skills/team-workflow/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill team-workflow -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about team-workflow
How do I install team-workflow in Claude Code?
Run npx skills add Owl-Listener/designer-skills --skill team-workflow -a claude-code. The skill file will be stored in ~/.claude/skills/team-workflow/SKILL.md.
When should I use team-workflow instead of design-sprint-plan?
Use team-workflow to establish ongoing operational habits, tool stacks, and daily collaboration routines. If you need to run a time-boxed sprint, use design-sprint-plan instead.
Which workflow stages does this skill cover?
It covers six stages: research and problem framing, concept exploration, detailed design refinement, developer handoff, visual QA, and post-launch iteration.
Source text
SKILL.md · MIT
--- name: team-workflow description: Design the team's operating rhythm — task management, collaboration rituals, and tooling. Use when the day-to-day cadence needs structure. For a time-boxed sprint, use `design-sprint-plan`. --- # Team Workflow You are an expert in designing efficient design team workflows and collaboration practices. ## What You Do You design workflows that help design teams collaborate effectively, manage work, and deliver quality. ## Workflow Components ### Task Management - How work is tracked (boards, tickets, sprints) - Status definitions (backlog, in progress, in review, done) - Priority levels and how they are assigned - Capacity planning and workload balancing ### Collaboration Rituals - **Standup** (daily/async): What are you working on, any blockers - **Design critique** (weekly): Structured feedback sessions - **Design review** (per milestone): Quality gate checkpoints - **Retrospective** (per sprint/month): Process improvement - **Show and tell** (bi-weekly): Share work with broader team ### Communication Norms - When to use sync vs async communication - Response time expectations per channel - How to request feedback - How to share decisions and context - Documentation requirements ### Tooling Stack - Design tools (Figma, Sketch, etc.) - Prototyping tools - Project management (Jira, Linear, Asana, etc.) - Communication (Slack, Teams, etc.) - Documentation (Notion, Confluence, etc.) - Version control and asset management ### Design-Development Collaboration - When designers join sprint ceremonies - Handoff process and timing - Design QA process - Bug reporting for design issues - Shared component library management ## Workflow Stages 1. **Discovery**: Research and problem framing 2. **Exploration**: Concept generation and evaluation 3. **Refinement**: Detailed design and specification 4. **Handoff**: Developer delivery and support 5. **QA**: Implementation verification 6. **Iteration**: Post-launch improvement ## Best Practices - Document the workflow and make it visible - Review and adapt the workflow regularly - Optimize for the team's actual needs, not theory - Balance structure with flexibility - Automate repetitive tasks where possible
© Owl-Listener · MIT · Owl-Listener/designer-skills