Agent skill

Shape

by growupanand in growupanand/ConvoForm

Plan the UX and UI for a feature before writing code. An agent skill from growupanand/ConvoForm.

Apache-2.0Auto-check passedProduct & Project Management

Install Shape

skills CLI
$ npx skills add growupanand/ConvoForm --skill shape -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install growupanand/ConvoForm shape --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/growupanand/ConvoForm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/shape .claude/skills/shape && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
shape
GitHub stars
101
Used in
5 other repos
Token cost
~1.3k tokens
SKILL.md length
686 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

Plan the UX and UI for a feature before writing code. An agent skill from growupanand/ConvoForm.

  • Works in 2 steps: Discovery Interview → Design Brief
  • Tasks that involve User research
  • SKILL.md covers MANDATORY PREPARATION, Philosophy, Phase 1: Discovery Interview and Phase 2: Design Brief
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Shape is an agent skill from growupanand/ConvoForm. Plan the UX and UI for a feature before writing code. Runs a structured discovery interview, then produces a design brief that guides implementation. Use during the planning phase to establish design direction, constraints, and strategy before any code is written.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering User research. The repository describes itself as: Turn Forms into Conversations with AI. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve User research

Example prompts

  • “/shape”

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Discovery Interview
  2. Design Brief

What it can do on your machine

Read from SKILL.md and the folder at commit 36dcb51. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Shape loads about 1.3k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 686 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from growupanand/ConvoForm at commit 36dcb51, republished under its Apache-2.0 licence (© growupanand). 686 words, ~1,268 tokens.

Download SKILL.mdSave it as .claude/skills/shape/SKILL.md (or your agent's skills folder).
name
shape
description
Plan the UX and UI for a feature before writing code. Runs a structured discovery interview, then produces a design brief that guides implementation. Use during the planning phase to establish design direction, constraints, and strategy before any code is written.
user-invocable
true
argument-hint
[feature to shape]

MANDATORY PREPARATION

Invoke /impeccable, which contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding. If no design context exists yet, you MUST run /impeccable teach first.


Shape the UX and UI for a feature before any code is written. This skill produces a design brief: a structured artifact that guides implementation through discovery, not guesswork.

Scope: Design planning only. This skill does NOT write code. It produces the thinking that makes code good.

Output: A design brief that can be handed off to /impeccable craft, /impeccable, or any other implementation skill.

Philosophy

Most AI-generated UIs fail not because of bad code, but because of skipped thinking. They jump to "here's a card grid" without asking "what is the user trying to accomplish?" This skill inverts that: understand deeply first, so implementation is precise.

Phase 1: Discovery Interview

Do NOT write any code or make any design decisions during this phase. Your only job is to understand the feature deeply enough to make excellent design decisions later.

Ask these questions in conversation, adapting based on answers. Don't dump them all at once; have a natural dialogue. ask the user directly to clarify what you cannot infer.

Purpose & Context
  • What is this feature for? What problem does it solve?
  • Who specifically will use it? (Not "users"; be specific: role, context, frequency)
  • What does success look like? How will you know this feature is working?
  • What's the user's state of mind when they reach this feature? (Rushed? Exploring? Anxious? Focused?)
Content & Data
  • What content or data does this feature display or collect?
  • What are the realistic ranges? (Minimum, typical, maximum, e.g., 0 items, 5 items, 500 items)
  • What are the edge cases? (Empty state, error state, first-time use, power user)
  • Is any content dynamic? What changes and how often?
Design Goals
  • What's the single most important thing a user should do or understand here?
  • What should this feel like? (Fast/efficient? Calm/trustworthy? Fun/playful? Premium/refined?)
  • Are there existing patterns in the product this should be consistent with?
  • Are there specific examples (inside or outside the product) that capture what you're going for?
Constraints
  • Are there technical constraints? (Framework, performance budget, browser support)
  • Are there content constraints? (Localization, dynamic text length, user-generated content)
  • Mobile/responsive requirements?
  • Accessibility requirements beyond WCAG AA?
Anti-Goals
  • What should this NOT be? What would be a wrong direction?
  • What's the biggest risk of getting this wrong?
Show full SKILL.md (287 more words)Show less

Phase 2: Design Brief

After the interview, synthesize everything into a structured design brief. Present it to the user for confirmation before considering this skill complete.

Brief Structure

1. Feature Summary (2-3 sentences) What this is, who it's for, what it needs to accomplish.

2. Primary User Action The single most important thing a user should do or understand here.

3. Design Direction How this should feel. What aesthetic approach fits. Reference the project's design context from .impeccable.md and explain how this feature should express it.

4. Layout Strategy High-level spatial approach: what gets emphasis, what's secondary, how information flows. Describe the visual hierarchy and rhythm, not specific CSS.

5. Key States List every state the feature needs: default, empty, loading, error, success, edge cases. For each, note what the user needs to see and feel.

6. Interaction Model How users interact with this feature. What happens on click, hover, scroll? What feedback do they get? What's the flow from entry to completion?

7. Content Requirements What copy, labels, empty state messages, error messages, and microcopy are needed. Note any dynamic content and its realistic ranges.

8. Recommended References Based on the brief, list which impeccable reference files would be most valuable during implementation (e.g., spatial-design.md for complex layouts, motion-design.md for animated features, interaction-design.md for form-heavy features).

9. Open Questions Anything unresolved that the implementer should resolve during build.


ask the user directly to clarify what you cannot infer. Get explicit confirmation of the brief before finishing. If the user disagrees with any part, revisit the relevant discovery questions.

Once confirmed, the brief is complete. The user can now hand it to /impeccable craft to build the feature, or use it to guide any other implementation approach.

© growupanand, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/shape of growupanand/ConvoForm.

Open the folder on GitHubat commit 36dcb51

Used in 5 other repositories

We found 7 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in growupanand/ConvoForm, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Shape next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Shape compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shape this skillgrowupanand/ConvoForm1015 repos~1.3kAutomated safety check: PassApache-2.0
User Research Cookiycookiy-ai/user-research-skill1.6k—~954Automated safety check: PassMIT
Fable DomainSahir619/fable-method2.3k—~2.6kAutomated safety check: PassMIT
Produck Feedback To Buildtryproduck/produck-skills510—~1kAutomated safety check: PassApache-2.0
MITRE Problem Framing Canvasdeanpeters/Product-Manager-Skills7.2k2 repos~4.5kAutomated safety check: PassCustom licence
Customer InterviewsRefoundAI/lenny-skills1.4k—~1.7kAutomated safety check: PassMIT

Similar skills

  • User Research Cookiy

    cookiy-ai/user-research-skill

    End-to-end user research assistant — qualitative and quantitative.

    1.6k GitHub stars~954 tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Fable Domain

    Sahir619/fable-method

    Discuss a domain with the user, research it from real sources, then generate a trusted skill bundle for it - a step-by-step workflow with a flowchart, a domain adapter, a trap fixture, and a smoke…

    2.3k GitHub stars~2.6k tokensUpdated 5 days ago
    Product & Project ManagementAuto-check passed
  • Produck Feedback To Build

    tryproduck/produck-skills

    Pulls full in-context user feedback tickets through the Produck MCP server and turns them into an aligned product change instead of a guess.

    510 GitHub stars~1k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • MITRE Problem Framing Canvas

    deanpeters/Product-Manager-Skills

    Guides a three-phase canvas, looking inward, looking outward, then reframing, to produce an equity-aware problem statement.

    7.2k GitHub starsUsed in 2 repos~4.5k tokens
    Product & Project ManagementAuto-check passed
  • Customer Interviews

    RefoundAI/lenny-skills

    Help users conduct high-impact customer interviews that move beyond surface-level feature requests to identify root emotional frustrations and specific causal triggers.

    1.4k GitHub stars~1.7k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • Guides a product discovery conversation and writes product-brief.md with the problem, evidence, scope, decisions and the next open question, for existing, client or own ideas.

    227 GitHub stars~3k tokensUpdated 3 days ago
    Product & Project ManagementAuto-check passed

More from growupanand/ConvoForm

All 11 skills in this repo
  • Animate

    growupanand/ConvoForm

    Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight.

    101 GitHub starsUsed in 6 repos~1.9k tokens
    Auto-check passed
  • Critique

    growupanand/ConvoForm

    Evaluate design from a UX perspective, assessing visual hierarchy, information architecture, emotional resonance, cognitive load, and overall quality with quantitative scoring, persona-based…

    101 GitHub starsUsed in 4 repos~3.4k tokens
    Auto-check passed
  • Audit

    growupanand/ConvoForm

    Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns.

    101 GitHub starsUsed in 6 repos~1.9k tokens
    Auto-check passed
  • Colorize

    growupanand/ConvoForm

    Add strategic color to features that are too monochromatic or lack visual interest, making interfaces more engaging and expressive.

    101 GitHub starsUsed in 6 repos~1.7k tokens
    Auto-check passed
  • Clerk Orgs

    growupanand/ConvoForm

    Clerk Organizations for B2B and multi-tenant apps - org switching, roles and permissions, verified domains, and enterprise SSO.

    101 GitHub stars~5.4k tokensUpdated yesterday
    Auto-check passed
  • Drizzle Orm

    growupanand/ConvoForm

    Type-safe SQL ORM for TypeScript with zero runtime overhead. An agent skill from growupanand/ConvoForm.

    101 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed

Questions about Shape

What does Shape do?

Plan the UX and UI for a feature before writing code. An agent skill from growupanand/ConvoForm. Shape is an agent skill from growupanand/ConvoForm. Plan the UX and UI for a feature before writing code.

When should I use Shape?

Shape fits situations like: tasks that involve User research.

How do I install Shape in Claude Code?

Run `npx skills add growupanand/ConvoForm --skill shape -a claude-code`. Or copy the skill folder (.agents/skills/shape in growupanand/ConvoForm) into .claude/skills/shape in your project. Claude Code loads it when a task matches its description.

How do I install Shape in Codex?

Run `npx skills add growupanand/ConvoForm --skill shape -a codex`. Or copy the skill folder (.agents/skills/shape in growupanand/ConvoForm) into .agents/skills/shape in your project. Codex loads it when a task matches its description.

Can I use Shape in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add growupanand/ConvoForm --skill shape -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shape, .gemini/skills/shape, .github/skills/shape and .opencode/skills/shape in your project.

What does Shape need to run?

SKILL.md names no scripts, command-line tools or credentials: Shape is instructions for the agent only.

Does Shape access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Shape safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Shape use?

Shape is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shape use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Shape?

Skills that share tags, products or a category with Shape: User Research Cookiy (cookiy-ai/user-research-skill, 1.6k stars), Fable Domain (Sahir619/fable-method, 2.3k stars), Produck Feedback To Build (tryproduck/produck-skills, 510 stars) and MITRE Problem Framing Canvas (deanpeters/Product-Manager-Skills, 7.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shape?

growupanand (a GitHub user) maintains it in growupanand/ConvoForm, which has 101 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 6, 2026.

Source: growupanand/ConvoForm on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.