collaborative-design

STARTER_CHARACTER = 🎨

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "collaborative-design" with this command: npx skills add lexler/skill-factory/lexler-skill-factory-collaborative-design

STARTER_CHARACTER = 🎨

Purpose

Stay in design mode. Resist jumping to implementation. Explore the problem space through concrete scenarios and visual examples before committing to solutions.

Core Principle: Show, Don't Tell

Instead of describing what happens in prose, show it visually. Before/after states, input/output pairs, UI mockups - whatever fits the domain. Visual beats prose.

Bad: "The system strips Claude co-authors and keeps human ones" Good: Show the actual input and expected output side by side

Process

Problem β†’ Research β†’ Timeline β†’ Scenarios β†’ Decisions β†’ Validation ↑__________________________________________________| (iterate freely)

  1. Clarify the Problem
  • What are we building? Why?

  • What does success look like?

  • What constraints exist?

  1. Research (if needed)
  • Analyze existing patterns (logs, code, APIs)

  • Check real-world examples

  • Validate assumptions about formats, timing, etc.

  1. Think in Timeline

Once the problem is understood, walk through what happens in order:

  • What happens first?

  • Then what?

  • What triggers the next step?

This uncovers unknowns. Each step becomes a scenario to explore.

  1. Show Scenarios Visually

For each scenario, show the transformation or state change. Format depends on domain:

  • Config/data: show before and after

  • UI: show screen states and transitions

  • Pipelines: show input β†’ output

  • Workflows: show steps with arrows

Use domain language. Stay high-level. Show complete examples, don't truncate.

  1. Surface Options, Then Decide

Present several options with tradeoffs. Don't decide alone:

  • "Option A does X, Option B does Y. Which direction?"

  • Wait for input before proceeding

  1. Validate Before Building
  • POC for risky assumptions (API timing, format parsing)

  • Visual test cases (input β†’ expected output)

  • Document findings

  1. Document Decisions

Track what was decided and why. Update docs as design evolves.

Anti-patterns

  • Jumping to code before exploring the design space

  • Describing scenarios in prose instead of showing them visually

  • Showing one solution instead of options

  • Asking multiple questions at once (show the whole list, then ask each one at a time)

  • Making assumptions without checking (real data, real APIs)

  • Skipping visuals for "obvious" cases

  • Truncating examples (show complete data)

  • Deciding without discussing tradeoffs

When to Exit Design Mode

  • Problem is understood

  • Key scenarios walked through (shown visually)

  • Major decisions made and documented

  • Test cases exist as visual examples

  • Risky assumptions validated

Then: implementation.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

hexagonal-architecture

No summary provided by upstream source.

Repository SourceNeeds Review
General

using-uv

No summary provided by upstream source.

Repository SourceNeeds Review
General

refinement-loop

No summary provided by upstream source.

Repository SourceNeeds Review