CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codex-qa

QA the omo Codex Light edition (lazycodex / packages/omo-codex) itself, in strict isolation so ONLY our plugin is exercised, never the user's real ~/.codex. The first-party method drives the real `codex app-server` against an isolated CODEX_HOME plus a LOCAL mock model (no real API call), and proves a plugin hook fired by asserting hook/started + hook/completed notifications. Also: isolated install verification, per-component hook probes, a tmux TUI smoke, and runtime log observation (RUST_LOG / logs SQLite / /debug-config). Ships tested helper scripts each with a --self-test. Use whenever someone changes anything under packages/omo-codex or wants to QA, smoke-test, verify, or debug the Codex plugin, its hooks/components, the installer/config.toml, the app-server flow, or the Codex TUI. Triggers: codex qa, qa codex, codex-qa, test codex plugin, verify codex hook, codex app-server, lazycodex qa, isolated CODEX_HOME, prove codex hook fired, codex tui test.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

This is a strong, highly executable skill body: correct isolation model, explicit safety assertions, self-testing scripts, and clean one-level-deep references. Its only real weakness is mild token bloat from tangential sections (dev-build detection, web-terminal visual QA) and repeated safety guarantees that could be consolidated into a reference file.

Suggestions

Move the web-terminal visual QA walkthrough and the `bun run install:codex-dev` dev-build detection paragraph into a reference file (e.g. references/visual-qa.md), leaving a one-line pointer in the body to cut tangential tokens.

State the 'real ~/.codex is shasum-verified unchanged' guarantee once in the golden rules and drop its repetition in the scripts index and elsewhere.

Document the `--plugin` flag for scripts/tui-smoke.sh in the scripts index (the body references `tui-smoke.sh --plugin` but the index only describes its `--self-test`).

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence (no explanation of what codex or tmux is; commands given directly), but there is trimmable material: the `bun run install:codex-dev` dev-build detection paragraph is tangential to the QA flow, the web-terminal visual QA section is detailed enough to belong in a reference file, and the 'real `~/.codex` unchanged' guarantee is repeated across the golden rules, scripts index, and elsewhere. These are minor instances of over-explanation, matching the score-4 anchor rather than the lean score-5 anchor.

4 / 5

Actionability

Guidance is copy-paste ready throughout: `bash scripts/lib/common.sh --self-check`, a router table giving the exact script and flag per case (`scripts/app-server-drive.sh --plugin`, `scripts/hook-unit-probe.sh --self-test`, etc.), and an evidence-capture block with real commands (`ev=".omo/evidence/$(date +%Y%m%d)-codex-qa-<slug>"; mkdir -p "$ev"` plus two full script invocations). The router covers the common cases and the manual fallback rule (`export CODEX_HOME="$(mktemp -d)/codex"`) is executable as written.

5 / 5

Workflow Clarity

The flow is clearly sequenced — setup self-check, router by need, matching QA to change scope, then evidence capture — with explicit validation checkpoints: each script's `--self-test` 'asserts its scenario against the live machine', every script 'shasums `~/.codex/config.toml` before and after and asserts it unchanged', and the hard rule 'no evidence file == the QA did not happen'. These are genuine feedback loops (assert → capture evidence → fail loudly), matching the top anchor.

5 / 5

Progressive Disclosure

The SKILL.md body is a well-signaled overview with a router table linking each case to one-level-deep references, and all six linked files (isolation.md, app-server.md, docker-qa.md, install-verify.md, components-hooks.md, logging-debug.md) actually exist in the bundle alongside the referenced scripts. Content is appropriately split: decisions and commands inline, deep dives in references — matching the clear-overview anchor. The only blemish is that a few repo-level paths (script/agent/qa-docker.sh, docs/reference/web-terminal-visual-qa.md) point outside the skill bundle, but the in-bundle structure itself is exemplary.

5 / 5

Total

19

/

20

Passed

Description

100%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.

The description is a model example: third-person, densely specific, with explicit what/when structure and a comprehensive natural-language trigger list. It is longer than typical but every clause carries information, so the length reads as coverage rather than padding.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'drives the real `codex app-server` against an isolated CODEX_HOME plus a LOCAL mock model', 'asserting hook/started + hook/completed notifications', 'isolated install verification, per-component hook probes, a tmux TUI smoke, and runtime log observation' — giving comprehensive coverage of the skill's QA capabilities with no vague filler.

5 / 5

Completeness

Both 'what' and 'when' are explicitly answered: the what is the detailed method paragraph (app-server + mock model + notification assertions plus supporting scripts), and the when is 'Use whenever someone changes anything under packages/omo-codex or wants to QA, smoke-test, verify, or debug the Codex plugin, its hooks/components, the installer/config.toml, the app-server flow, or the Codex TUI' with concrete trigger phrases appended.

5 / 5

Trigger Term Quality

The explicit trigger list covers natural synonyms and phrasings users would say: 'codex qa, qa codex, codex-qa, test codex plugin, verify codex hook, codex app-server, lazycodex qa, isolated CODEX_HOME, prove codex hook fired, codex tui test'. This is comprehensive coverage including repo-specific and command-shaped variants.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — QA of a specific plugin (lazycodex / packages/omo-codex) in strict isolation — and its triggers are scoped to that niche ('lazycodex qa', 'verify codex hook', 'codex-qa'), so it is unlikely to fire for unrelated skills. Minor residual overlap only with hypothetical other Codex skills, which keeps it at the top anchor rather than below.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

code-yeongyu/oh-my-openagent

Path

.agents/skills/codex-qa/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.