Audit user stories for disability inclusion. An agent skill from Owl-Listener/inclusive-design-skills.

MITAuto-check passedProduct & Project Management

Install Audit Stories

skills CLI
$ npx skills add Owl-Listener/inclusive-design-skills --skill audit-stories -a claude-code

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

GitHub CLI
$ gh skill install Owl-Listener/inclusive-design-skills audit-stories --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/Owl-Listener/inclusive-design-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/inclusive-personas/skills/audit-stories .claude/skills/audit-stories && 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
audit-stories
GitHub stars
105
Token cost
~501 tokens
SKILL.md length
246 words
Files
1
Skills in repo
55
Repo updated
First seen
Licence
MIT

At a glance

Audit user stories for disability inclusion. An agent skill from Owl-Listener/inclusive-design-skills.

  • Works in 4 steps: Gather Stories → Check Each Story → Check for Assumption Bias → …
  • Reviewing an existing backlog
  • SKILL.md covers Process and Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Audit Stories is an agent skill from Owl-Listener/inclusive-design-skills. Audit user stories for disability inclusion. Chains: inclusive-user-stories, edge-case-identification. Use when reviewing an existing backlog, sprint, or set of user stories to check whether they account for diverse abilities.

Its SKILL.md is about 500 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 stories. The repository describes itself as: Inclusive design skills for AI coding agents — from cognitive accessibility to adaptive interfaces, inclusive research, and accessibility decision-making. The licence is MIT.

When your agent uses it

  • Reviewing an existing backlog
  • Set of user stories to check whether they account for diverse abilities

Example prompts

  • “/audit-stories”

Workflow steps

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

  1. Gather Stories
  2. Check Each Story
  3. Check for Assumption Bias
  4. Add Missing Criteria

What it can do on your machine

Read from SKILL.md and the folder at commit 6e0740f. 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

Audit Stories loads about 501 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 246 words of instructions outside code blocks.

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

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 Owl-Listener/inclusive-design-skills at commit 6e0740f, republished under its MIT licence (© Owl-Listener). 246 words, ~501 tokens.

Download SKILL.mdSave it as .claude/skills/audit-stories/SKILL.md (or your agent's skills folder).
name
audit-stories
description
Audit user stories for disability inclusion. Chains: inclusive-user-stories, edge-case-identification. Use when reviewing an existing backlog, sprint, or set of user stories to check whether they account for diverse abilities.

Audit User Stories for Inclusion

Review an existing set of user stories and identify where disability and diverse abilities have been overlooked — then add the missing criteria without creating separate accessibility tickets.

Process

Step 1: Gather Stories

Collect the user stories to audit. This could be a sprint backlog, a feature's full story set, or an epic.

Step 2: Check Each Story

Using inclusive-user-stories, review each story's acceptance criteria for:

  • Keyboard operability
  • Screen reader support
  • Visual accessibility (contrast, colour independence, zoom)
  • Motor accessibility (target size, timing, precision)
  • Cognitive accessibility (plain language, error recovery, undo)

Flag any story where one or more of these are missing.

Step 3: Check for Assumption Bias

Using edge-case-identification, for each story ask:

  • What input method does this assume?
  • What sensory ability does this assume?
  • What cognitive capacity does this assume?
  • What context does this assume?
  • What "edge cases" have been dismissed that are daily reality for some users?
Step 4: Add Missing Criteria

For each flagged story, write the specific acceptance criteria that need to be added. Don't create separate stories — add directly to the existing ones.

Output

Deliver an audit report:

  1. Summary — number of stories reviewed, number with gaps, most common gap type
  2. Story-by-story findings — each story with its missing criteria listed
  3. Added criteria — the specific acceptance criteria to add to each story, ready to paste into the backlog
  4. Patterns — recurring gaps that suggest a systemic issue (e.g., "no story in this sprint mentions keyboard access")

© Owl-Listener, MIT. 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 inclusive-personas/skills/audit-stories of Owl-Listener/inclusive-design-skills.

Open the folder on GitHubat commit 6e0740f

Compare with similar skills

Audit Stories 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.

Audit Stories compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Audit Stories this skillOwl-Listener/inclusive-design-skills105—~501Automated safety check: PassMIT
User Story Writerdeanpeters/Product-Manager-Skills7.2k2 repos~2.9kAutomated safety check: PassCustom licence
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Agile Product Owneralirezarezvani/claude-skills28k3 repos~3.2kAutomated safety check: PassMIT
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
To Specbestofjs/bestofjs3.1k21 repos~757Automated safety check: PassMIT

Similar skills

  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Product & Project ManagementAuto-check passed
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • To Spec

    bestofjs/bestofjs

    Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

    3.1k GitHub starsUsed in 21 repos~757 tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed

More from Owl-Listener/inclusive-design-skills

All 55 skills in this repo
  • Assistive Technology Scenarios

    Owl-Listener/inclusive-design-skills

    Writes usage scenarios, use cases and storyboards that show real people using screen readers, switches, voice control and other assistive technology to finish tasks.

    105 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Error Prevention and Recovery

    Owl-Listener/inclusive-design-skills

    Designs forgiving forms and flows: prevent input errors, write messages that say what happened and what to do, and add undo, confirmation and recovery paths.

    105 GitHub stars~739 tokensUpdated 4 mo ago
    Auto-check passed
  • Accessible Heading Structure

    Owl-Listener/inclusive-design-skills

    Designs heading hierarchies for screen reader navigation and cognitive accessibility on pages, articles, dashboards and forms.

    105 GitHub stars~763 tokensUpdated 4 mo ago
    Auto-check passed
  • Ability Spectrum Mapping

    Owl-Listener/inclusive-design-skills

    Maps a feature across a range of vision, hearing, motor and cognitive ability to find where the design starts to fail, and to explain accessibility scope to stakeholders.

    105 GitHub stars~917 tokensUpdated 4 mo ago
    Auto-check passed
  • Accessibility Debt Tracking

    Owl-Listener/inclusive-design-skills

    Track and manage accessibility debt — known accessibility issues that have been deferred.

    105 GitHub stars~869 tokensUpdated 4 mo ago
    Auto-check passed
  • Accessibility Testing Strategy

    Owl-Listener/inclusive-design-skills

    Plan what to test, how to test, and who should test for accessibility.

    105 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Audit Stories

What does Audit Stories do?

Audit user stories for disability inclusion. An agent skill from Owl-Listener/inclusive-design-skills. Audit Stories is an agent skill from Owl-Listener/inclusive-design-skills. Audit user stories for disability inclusion.

When should I use Audit Stories?

Audit Stories fits situations like: reviewing an existing backlog; set of user stories to check whether they account for diverse abilities.

How do I install Audit Stories in Claude Code?

Run `npx skills add Owl-Listener/inclusive-design-skills --skill audit-stories -a claude-code`. Or copy the skill folder (inclusive-personas/skills/audit-stories in Owl-Listener/inclusive-design-skills) into .claude/skills/audit-stories in your project. Claude Code loads it when a task matches its description.

How do I install Audit Stories in Codex?

Run `npx skills add Owl-Listener/inclusive-design-skills --skill audit-stories -a codex`. Or copy the skill folder (inclusive-personas/skills/audit-stories in Owl-Listener/inclusive-design-skills) into .agents/skills/audit-stories in your project. Codex loads it when a task matches its description.

Can I use Audit Stories 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 Owl-Listener/inclusive-design-skills --skill audit-stories -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/audit-stories, .gemini/skills/audit-stories, .github/skills/audit-stories and .opencode/skills/audit-stories in your project.

What does Audit Stories need to run?

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

Does Audit Stories 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 Audit Stories 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 Audit Stories use?

Audit Stories is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Audit Stories use?

About 501 tokens (SKILL.md is roughly 2k 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 Audit Stories?

Skills that share tags, products or a category with Audit Stories: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Agile Product Owner (alirezarezvani/claude-skills, 28k stars) and Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Audit Stories?

Owl-Listener (a GitHub user) maintains it in Owl-Listener/inclusive-design-skills, which has 105 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on June 9, 2026.

Source: Owl-Listener/inclusive-design-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.