# Persona Audit

> Run a randomised persona-based UX audit of your application. Use when asked to 'audit', 'test personas', 'run a UX check', 'QA the app', 'persona audit', or 'test the app with fake users'. Generates unique user personas, discovers bugs and UX issues via agent teams, verifies them, implements fixes, and verifies fixes work. Do NOT use for non-web projects, general manual testing, deployment tasks,…

- **Type:** Skill
- **Install:** `agentstack add skill-jara-r-k-claude-code-skills-persona-audit-pattern`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jara-r-k](https://agentstack.voostack.com/s/jara-r-k)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jara-r-k](https://github.com/jara-r-k)
- **Source:** https://github.com/jara-r-k/claude-code-skills/tree/master/examples/persona-audit-pattern

## Install

```sh
agentstack add skill-jara-r-k-claude-code-skills-persona-audit-pattern
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Persona Audit

Run persona-driven QA cycles using agent teams. This is a **template** — adapt it to your project by replacing the placeholders below.

## Configuration (customise these)

Before using this skill, update the following in your copy:

- **`PROJECT_PATH`**: Path to your project directory
- **`AGENT_PATH`**: Path to the agent definition file (see `references/agent-template.md`)
- **`APP_URL`**: Your local dev server URL (e.g., `http://localhost:3000`)
- **`FOCUS_AREAS`**: List of focus areas relevant to your app (e.g., `mobile`, `accessibility`, `checkout`, `onboarding`)

## Instructions

### Step 1: Locate the Agent Skill

The agent definition should be at:
`PROJECT_PATH/.claude/agents/your-persona-audit-agent.md`

Create this file using the template in `references/agent-template.md`.

### Step 2: Pass Arguments

If the user provides a focus area (e.g., `/persona-audit mobile`), pass it through to the agent. If no focus area is specified, use date-based randomisation to select from your configured focus areas:

```
focus_index = (day_of_month) % len(FOCUS_AREAS)
```

### Step 3: Expected Outputs

- Audit report written to `docs/audit-runs/YYYY-MM-DD-audit.md` in your project
- Bug fixes applied directly to source code
- Compilation/type-checking verified
- Screenshot evidence captured via preview tools (if available)

## Error Handling

### Agent file not found
- **Cause**: Project not at expected path or agent file not created
- **Solution**: Verify `PROJECT_PATH` exists and contains the agent definition

### Dev server fails to start
- **Cause**: Port in use or configuration issue
- **Solution**: Check for port conflicts. Verify dev server configuration.

### No project directory
- **Cause**: Skill invoked outside the project context
- **Solution**: Ensure the working directory is set to your project or specify the path explicitly.

## Examples

### Run with default focus
```
/persona-audit
```
Uses date-based rotation to select today's focus area.

### Focus on mobile testing
```
/persona-audit mobile
```
All personas tested at mobile viewport. Checks touch targets, overflow, and responsive layout.

### Focus on accessibility
```
/persona-audit accessibility
```
Tests screen reader compatibility, keyboard navigation, colour contrast, and motor impairment scenarios.

## Important

- The agent spawns multiple discovery, verification, and fix agents. Expect significant runtime.
- Changes are made locally only — do NOT push to remote.
- Always verify compilation passes after fixes.
- Adapt the persona generation to your application's user demographics.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jara-r-k](https://github.com/jara-r-k)
- **Source:** [jara-r-k/claude-code-skills](https://github.com/jara-r-k/claude-code-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jara-r-k-claude-code-skills-persona-audit-pattern
- Seller: https://agentstack.voostack.com/s/jara-r-k
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.