⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

ryux-prose

ryuxdsgn@ryuxdsgn⭐ 152 stars· last commit 2d ago· 0 open issues

Writing or revising this repo's public-facing text — the README, PR titles and bodies, benchmark docs, release notes, the GitHub description, replies on issues and discussions. Load before drafting or editing any of them. Carries the voice, the narrative arc, and the hard rules (claim scope, rater wording, no version labels) that public ryux text must keep.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 152 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

Understand before you design.

A design skill for AI agents. Your agent asks about the product before it designs, keeps what it does not know out of the screens instead of inventing fees, promos, and policies, designs for when things go wrong, and explains each decision.

npx @ryuxdsgn/design-intelligence

Works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Cline, Amp, Kimi Code, and Antigravity. Free, MIT.

Given a one-line brief for an order-tracking prototype, agents without a skill made up 28 business rules across three runs and showed them as fact: refund times, a $4.99 cancellation fee, courier ratings, a late-delivery guarantee. With RYUX: 1, counted blind (order tracking benchmark).

No skill vs RYUX

Same short brief, same agent (Claude Code), one side with RYUX. Quotes are the agent's own words from that run; scores are blind ratings, 1 to 5, by a senior designer who didn't know which side used RYUX. The principles the callouts name (Fitts, Hick, Gestalt, Nielsen's heuristics, WCAG) and the rules built on them are listed in Design principles.

Checkout, from one sentence. The brief names the product (Sejuk, an iOS app for booking an AC technician in Jakarta) and nothing else. Without a skill, the agent filled the gaps with a price, fees, a promo code, a warranty, and a cancellation rule. The RYUX run asked first: which direction, how the price is set, how people pay, what the screen may promise. Told to go with its recommended direction, it took its other recommendations as assumptions, labelled the price and payment as not decided, left out fees and promises, and built five states.

Blind rating: 4.33 with RYUX, 2.83 without; honesty 5 v 1, states 5 v 1, visual direction 4 v 2. The screen without a skill fit the AC service better (5 v 4), and copy tied (4 v 4). Checkout benchmark

Illustration. Asked for the service icons, an empty state, and a success screen, the RYUX run built one system from the product: the same AC unit in every icon, no steam that would read as heat, a technician on a motorbike as in Jakarta. The brief asked for Indonesian copy; for this image it was translated to English the same way on both sides, and the art is unchanged.

Blind rating of these two runs: 4.06 with RYUX, 3.06 without; over both runs per side, 3.97 v 3.00 (illustration benchmark).

Motion, in a clickable prototype. Asked for a booking flow with motion for each step, the RYUX run asked about price, payment, and rules first. With its defaults agreed, it labelled the price as an estimate, showed no fee or cancellation policy, and gave each movement a job: a slide for a step deeper, visible progress while booking, a fade for the finished booking.

Blind rating from the recordings: 3.83 with RYUX, 3.00 without; honesty 4 v 2, visual direction 4 v 2, motion 4 v 3. Craft tied at 3: in both, the button label overlaps during the confirm transition. Motion benchmark

Direction, before the first screen. Same one-sentence checkout brief. Without a skill, the agent drew one screen; its only line on visual direction was about colour. The RYUX run first offered three directions drawn from the product and its city, each with its risk, then built the checkout in the one it recommended, with every undecided price and rule in Figma annotations rather than on the screen.

Not rated: a later RYUX run with the same brief, set against the no-skill run above. [Checkout benchmark](docs/benchmarks/check

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • .claude/skills/ryux-prose/SKILL.md3.7 KB9c89a70a8a21upstream ↗
    ---
    name: ryux-prose
    description: Writing or revising this repo's public-facing text — the README, PR titles and bodies, benchmark docs, release notes, the GitHub description, replies on issues and discussions. Load before drafting or editing any of them. Carries the voice, the narrative arc, and the hard rules (claim scope, rater wording, no version labels) that public ryux text must keep.
    ---
    
    # ryux-prose — how this repo speaks in public
    
    This skill governs text people read on GitHub. It does not change the product skill
    (`skills/ryux`), code, or internal docs.
    
    ## Voice
    
    English, plain, specific. One mental model per surface; if a paragraph introduces a second
    way to think about RYUX, cut one. Short sentences carry claims; long sentences carry
    reasoning, never both at once. Translate jargon the first time it appears ("Delivery Gate —
    the checklist a run must pass before it ships"), then use the term. Prefer the concrete
    noun to the category: "a cashier tapping QRIS forty times a day", not "high-frequency users".
    
    ## The arc
    
    Public text that reports work (a benchmark, a release note, a README section) tells one
    story, in this order:
    
    1. **The task someone faced.** Open in the scene, not the abstraction: what a designer or
       developer was trying to do, and what made it hard.
    2. **What we did or tested.** The setup, blind where it was blind, with enough detail that
       a skeptic could rerun it.
    3. **What happened, measured.** Numbers with their meaning attached: "3.97 vs 3.00, rated
       blind on visual craft" — never a bare score. A failure is reported as plainly as a win.
    4. **What it means, and what is still open.** The honest ending: scope the conclusion to
       the evidence, name the next unknown.
    
    A reader who stops after the first paragraph should leave with the true conclusion.
    
    ## Hard rules
    
    These override style. Breaking one is a defect, not a choice.
    
    - **Claims scope to evidence.** One screen never becomes "apps do X". One run never becomes
      "RYUX always". Count the evidence in the sentence that leans on it.
    - **Rater wording.** In the README, ratings are "blind ratings by a senior designer"; the
      benchmark docs keep the fuller disclosure that the rater is the project owner and not
      independent — do not strip it. Never a plural raters claim until more than one human has
      rated.
    - **No version labels in the README** or its images; versions live in docs/benchmarks and
      release notes only.
    - **Never name a client's file, brand, or product.** "A client design file" is the ceiling.
    - **No invented numbers, quotes, users, or urgency.** Sample data is labelled sample.
    - **Failures ship.** A benchmark arm that lost, a criterion that failed, a feature that is
      untested — written in the same register as the wins.
    
    ## Structure survives the storytelling
    
    Narrative replaces filler, not format. Tables stay tables; command listings stay code
    blocks; a benchmark's criteria stay a list. Convert a list to prose only when it hides a
    sequence of cause and effect — then the prose must keep every item. Never pad: if the
    honest content is three sentences, the section is three sentences.
    
    ## PR titles and bodies
    
    The title says what changed, in the imperative register the log already uses. The body
    leads with the outcome ("## What" says what a reviewer will find, first sentence = the
    change), then the reason, then "## Tested" with real results — counts, passes, and what
    was *not* tested. No suspense, no journey, no "excited to".
    
    ## Words to strike on sight
    
    Hype adjectives (revolutionary, blazingly, powerful, seamless), "simply" and "just" before
    an instruction, exclamation marks outside quoted copy, emoji outside established page
    names, "very" doing the work an exact number should do, and any sentence that praises RYUX
    instead of showing a result.
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/ryuxdsgn-design-intelligence-claude-skills-ryux-prose.md

// REPO STATS

152 stars
0 open issues
Last commit: 2d ago