Two Claude skills instead of one

The most useful design decision I made here wasn't in Figma. It was where I drew the line between two tools.

Role

Product Designer & Content Strategist, sole UX writer across three lines. AI-native workflow, tool design.

Context

Accolade, 2025. B2B proptech SaaS.

Outcome

Two of three skills adopted; the one that didn't is the proof

The obvious build was one UX Copy skill with a write/review toggle. Because designers say 'review my copies' but never 'write,' I split it into two named skills: UX review got adopted and self-served, while UX writing stayed my own tool with the same demo. A separate support-docs skill served two PMs. Adoption is drawn before the first prompt.

One tool became two, named for the words people already use.

The product

Accolade is a B2B SaaS platform for multifamily property operations - how teams run leasing and maintenance across a portfolio of communities, increasingly through AI-driven tools like automated tour scheduling and a multilingual phone assistant. Getting teams to actually adopt those tools is its own design problem. For more information, see www.accoladehq.com

The chair

I came into product design through writing, so I listen to the exact words people use to ask for work; that's a content strategist's ear. Most people build an internal AI tool by reaching for engineering questions: what does it do, how good is the output. I reach for a design question: what is this tool for, and who reaches for it? The most consequential decision here wasn't a prompt. It was where I drew the boundary between two tools, and I drew it by listening to how my teammates already talk.

Context

At Accolade I was the entire UX writing function: one person supporting my own product work plus two other PMs, across three product lines. I was the bandwidth bottleneck; PM workflows stalled waiting on me for copy. So I built tools to scale myself and let people self-serve when I was out. Self-initiated, AI-native: Claude skills, not a doc. But the interesting part isn't that I used AI. It's the design call I made with it.

The question: one tool or two?

The obvious build is a single "UX Copy" skill with a mode toggle: write-mode and review-mode behind one dropdown. I didn't build that. I split it into two separately named skills, a UX writing skill and a UX review skill, plus a third, separate support-documentation skill aimed at PMs.

How I knew where to draw the line

I didn't guess. I listened to how designers actually asked me for help. They always said "can you review my copies." They never once said "can you write my copies." That's the whole signal.

A tool named "UX review" hooks into a request they already make out loud; a tool named "UX writing" has nothing in their vocabulary to attach to, no matter how good it is. The boundary between the two tools wasn't a technical convenience; it mapped onto language people already used.

What I built

UX review skill · lightweight first-pass copy checks, named for the request designers already made, built to self-serve when I'm OOO.

A designer invokes /accolade-ux-reviewer, attaches the PRD first, and the skill confirms it has the full context and label references before reviewing screenshots uploaded batch by batch against the voice, mechanics, kill list, component rules, and Alex check
PRD first, then screenshots reviewed batch by batch.
A UX Review batch: each finding logged with String, Where, Severity, Rule, Issue, and Rewrite, e.g. flagging a missing apostrophe in a greeting header and a vague 'Manage view' button
Findings logged by zone: string, severity, rule, rewrite.

UX writing skill · deep-judgment copy from a PRD plus Figma/prototype, the highest-judgment work, which I don't think should be delegated. This stayed my own workflow tool.

The accolade-ux-writer Claude skill: a SKILL.md defining Alex's voice (clear, concise, consistent, confident, empowering, human, professional) and a How to use this skill loop, identify the component type, elicit context, load the ux-writing-rules, then draft variants
Alex's voice compiled into a runnable skill.

Support-docs skill · a separate function pointed straight at PMs for feature-level documentation.

A PM asks the support-docs skill to create articles from a PRD and test-cases doc; the skill parses both first, notes PRD v2.0 with 11 use cases and 91 test cases, runs a clarifying workflow, and flags a terminology mismatch to verify before drafting
PM-facing: parses the PRD and test cases, then drafts feature docs.

I demoed each one hands-on to its target audience: designers for writing and review, PMs for docs.

Outcome, including the part that didn't land

The UX review skill got adopted: designers now self-serve first-pass checks when I'm out, and I do the final pass. The support-docs skill is in active use by two PMs. The UX writing skill, same audience, same demo, same me, didn't get adopted; it stayed my personal tool.

That gap is the whole point: review stuck and writing didn't, in the same window, so adoption wasn't about tool quality or my experience; it was about whether the name matched a request people already made. On throughput, my own committed turnaround to PMs moved from 4–5 days to 2–3 for copy, and 1–2 days to 1 for feature naming, over about two months.

Honest caveat

We had no tracker; that's the shift in the timelines I was committing to, not an instrumented metric. I'd rather tell you exactly where the number comes from than dress it up.

Published as "Bottleneck, no more!" on Medium

What I carry forward

Tool adoption is architected before you write a line of prompt. Most people would ship one skill with a mode parameter; I split it into two because adoption follows the user's existing language, not the tool's quality, and you can engineer that in advance by drawing tool boundaries to match how people already talk about the work.

Designers adopted by language match, PMs by competence match; same underlying rule: a tool gets picked up when it fits the model of the work already in someone's head.

"The AI is the medium. The design decision is in the architecture."