CtrlK
BlogDocsLog inGet started
Tessl Logo

pua-pro

PUA Pro alias for Codex. Codex subcommand mapping for Claude Code /pua:pro style usage; invoke with $pua-pro.

57

Quality

64%

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

Fix and improve this skill with Tessl

tessl review fix ./codex/pua-pro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

The body is admirably concise and well-scoped for a tiny alias/pointer skill, with sensible config-safety rules and a completion-evidence checkpoint. Its weakness is actionability: the central 'load and follow the pro skill/protocol' instruction is underspecified.

Suggestions

Specify how/where to load the pro skill/protocol (a path, command, or explicit 'invoke /pua:pro' step) so the core action is unambiguous.

Lightly sequence the steps (load protocol -> apply config changes safely -> verify with command/output evidence) to turn the rules into a clear workflow.

Clarify what 'command/output evidence' should look like before claiming completion, so the verification checkpoint is concrete.

DimensionReasoningScore

Conciseness

The body is lean with no padding or explanation of concepts Claude already knows; every sentence carries an instruction, matching the level-3 anchor.

3 / 3

Actionability

It gives concrete config rules ('preserve unknown fields', 'create ~/.pua/ if missing') but the core instruction 'Load and follow the pro skill/protocol' lacks where to load it from or how, leaving key details missing.

2 / 3

Workflow Clarity

The content is a set of behavioral rules rather than a sequenced workflow; one verification rule exists ('Do not claim completion without command/output evidence') but the load step is unspecified and checkpoints are implicit.

2 / 3

Progressive Disclosure

This is a simple skill under 50 lines with no bundle files and no need for external references; per the rubric's simple-skills note, adequate organization alone qualifies for the top score.

3 / 3

Total

10

/

12

Passed

Description

57%

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

The description clearly identifies a narrow, distinct niche but reads as jargon-heavy technical metadata rather than a user-facing capability statement. It states what the skill is but omits explicit 'when to use' trigger guidance.

Suggestions

Add an explicit 'Use when...' clause stating the user situations that should trigger this skill (e.g., 'Use when invoking the /pua:pro workflow from Codex').

Reword around natural trigger terms users would actually say, leading with the capability rather than 'alias for Codex' / 'subcommand mapping' jargon.

Name one or two concrete capabilities the alias exposes (self-evolution, telemetry, KPI, config commands) instead of only describing it as a mapping.

DimensionReasoningScore

Specificity

Names the domain ('Codex subcommand mapping', 'alias for Codex') and an action concept ('invoke with $pua-pro'), but does not list multiple concrete capabilities, so it falls short of the level-3 anchor.

2 / 3

Completeness

It answers 'what' (a Codex alias mapping) but provides no explicit 'Use when...' trigger guidance; per the rubric guideline a missing trigger clause caps completeness at 2.

2 / 3

Trigger Term Quality

It contains the real command tokens '/pua:pro' and '$pua-pro', but they are framed as technical jargon ('subcommand mapping', 'invoke with') rather than natural user language, missing common variations.

2 / 3

Distinctiveness Conflict Risk

The niche is narrow and specific (an alias for a single named command) with distinct trigger tokens, making it unlikely to fire for unrelated skills.

3 / 3

Total

9

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
tanweai/pua
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.