CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

persona-driven-issue-audit

Audita issues e fluxos em escala com personas representativas. Trigger em: "simulando usuarios reais diferentes", "fazer a IA impersonar persona e testar o app", "encontrar bugs de usabilidade em massa antes do lancamento", "numa auditoria, como triar tudo isso", "frota de agentes paralelos abrindo PR", "regras de dedup de issue quando varios agentes reportam", "abrir PR automatica ou comentar wontfix", "escalar QA exploratorio com IA sem virar gargalo", "simular usuario nao tecnico testando o produto", "PRs deveriam ser aprovadas automaticamente", "nao tenho personas escritas, da pra gerar a partir do repo", "auditoria automatica do produto sem preparar nada antes", "inferir persona a partir do codigo do projeto".

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

70%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered process skill: the six-phase funnel is unambiguously sequenced with validation checkpoints and completion evidence at every stage, and the guidance is concrete enough to execute. The costs are repetition of the same guardrails across four or five sections and a monolithic single-file structure with no reference bundle to offload phase-level detail.

Suggestions

State each guardrail once in the section where it binds (e.g., the no-auto-merge rule in Anti-Padrões, the proto-persona-is-not-research gate in Fase 1) and drop the verbatim repetitions in Fase 5, Evidência de Conclusão, Handoff, and Fontes — cross-reference the section instead.

Move stable detail out of SKILL.md into a references/ bundle: the persona .md template and Fase 1 inference heuristics (e.g., references/personas.md), the dedup and confidence-gate criteria (references/funnel-rules.md), and a verbatim funnel-report/issue-body template, leaving SKILL.md as a phase overview with one-level-deep links.

Add copy-paste-ready artifacts for the weakest executable spots: an issue body skeleton with the required fields (persona, rota, expectativa vs. resultado, passo-a-passo) and a minimal Fase 2 agent prompt showing the persona-as-context pattern.

DimensionReasoningScore

Conciseness

The body is dense and substantive with no basic-concept padding, but key rules are repeated across sections — "merge automático é decisão humana" appears in Fase 5, Anti-Padrões, and Evidência; the "proto-persona não é pesquisa real" gate appears in the boundary section, Fase 1, Anti-Padrões, Handoff, and Fontes; the fresh-context rationale is given twice — and several justificatory asides ("Dedup ruim gera o resultado inverso...") could be trimmed. Mostly efficient but with real tightening opportunities matches anchor 3.

3 / 5

Actionability

For an instruction-only orchestration skill the guidance is concrete: a stepwise dedup procedure keyed on route and root cause, a persona file template with mandatory fields including the `fonte:` traceability label, enumerated high-confidence criteria (a)–(d), and required specific wontfix reasons. Minor gaps keep it below anchor 5: no verbatim issue-body or funnel-report template, no example agent prompt for Fase 2, and tool dispatch ("podendo despachar mcp__Claude_Browser__* ou Playwright") is named without invocation detail.

4 / 5

Workflow Clarity

Six phases are explicitly sequenced (Fase 1–6) with entry/exit artifacts stated, and validation is embedded at every risky point: a human confirmation window before spending the funnel (Fase 1), dedup-before-open (Fase 2), analysis-before-fix separation (Fase 3), local test-suite run before opening a PR and a four-part confidence gate (Fase 4), per-PR review outcomes (Fase 5), and a literal completion checklist ("Evidência de Conclusão"). This matches the anchor-5 pattern of explicit validation steps, feedback loops, and checklists for a complex batch process.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so all detail lives inline in a ~183-line SKILL.md: persona-inference heuristics, the persona template, dedup rules, anti-patterns, and the funnel-report format would each work as a separate reference file linked from a shorter overview. The paths the body does cite (GLOBAL.md, policies/*.md, skills/51-ux-research, etc.) point to an external ecosystem and are not verifiable files in this bundle. Good internal headers, but content that should be separate is inline — anchor 3 rather than 4.

3 / 5

Total

15

/

20

Passed

Description

86%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with best-in-class trigger coverage: thirteen natural, varied trigger phrases that explicitly answer when to use the skill, plus a clear if thin capability statement. The main gaps are a one-clause "what" that undersells the six-phase funnel, and a few trigger phrases that overlap with adjacent review/swarm skills.

DimensionReasoningScore

Specificity

The capability statement is a single clause — "Audita issues e fluxos em escala com personas representativas" — which names the domain and one action but leaves the skill's other capabilities (persona inference, parallel fix, PR review, triage) implied only through trigger phrases rather than stated as actions. It sits above anchor 2 (the domain is specific, not generic like "Processes PDF files") but below anchor 4, which expects several concrete actions explicitly listed.

3 / 5

Completeness

Both questions are answered explicitly: what ("Audita issues e fluxos em escala com personas representativas") and when ("Trigger em:" followed by a list of concrete trigger phrases). This matches the anchor-5 example structure of a clear what plus explicit concrete triggers, and is above anchor 4 because the when-clause is maximally explicit rather than vague.

5 / 5

Trigger Term Quality

Thirteen natural phrases users would plausibly say, spanning the intent space with synonym variation: "simulando usuarios reais diferentes", "simular usuario nao tecnico testando o produto", "nao tenho personas escritas, da pra gerar a partir do repo", "regras de dedup de issue quando varios agentes reportam", "frota de agentes paralelos abrindo PR". Coverage matches the comprehensive-including-synonyms anchor.

5 / 5

Distinctiveness Conflict Risk

The persona-simulation mass-audit niche is clearly distinct (triggers like "inferir persona a partir do codigo do projeto" are unambiguous), but several triggers ("PRs deveriam ser aprovadas automaticamente", "abrir PR automatica ou comentar wontfix", "numa auditoria, como triar tudo isso") could plausibly fire for neighboring reviewer/swarm/security-review skills. Minor overlap with closely related skills matches anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository

felvieira/claude-skills-fv

Path

skills/62-persona-driven-issue-audit/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.