tkersey/refine
codex/skills/refine/SKILL.md
Refine an existing Codex skill in place with minimal diffs, then run quick_validate. Trigger for improving a skill's trigger description/frontmatter, workflow text, metadata, scripts/references/assets, or agents/openai.yaml; also iteration, refactor, rename, or fixes using usage/session-mining evidence such as `$seq`.
$ install --global
skillsauthnpx skillsauth add tkersey/dotfiles refineInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 29, 2026, 4:14 AM293.6s3 files scanned
SKILL.md
- name:
- refine
- description:
- Refine an existing Codex skill in place with minimal diffs, then run quick_validate. Trigger for improving a skill's trigger description/frontmatter, workflow text, metadata, scripts/references/assets, or agents/openai.yaml; also iteration, refactor, rename, or fixes using usage/session-mining evidence such as `$seq`.
Refine
Overview
Refine a target Codex skill by turning evidence into minimal, validated in-place updates.
Inputs
- Target skill name or path
- Improvement signals (user feedback, session mining notes, errors, missing steps)
- Constraints (minimal diff, required tooling, validation requirements)
Example Prompts
- "Refine the docx skill to tighten triggers and regenerate agents/openai.yaml."
- "Add a small script to the pdf skill, then validate it."
- "Use session-mining notes to refine the gh skill's workflow."
Workflow (Double Diamond)
Discover
- Read the target skill's
SKILL.md,agents/openai.yaml(if present), and anyscripts/,references/, orassets/. - Collect evidence from usage: confusion points, missing steps, bad triggers, or stale metadata.
- If no example prompts are provided, synthesize 2-3 realistic prompts that should trigger the skill.
Define
- Write a one-line problem statement and 2-3 success criteria.
- Choose the smallest change set that addresses the evidence.
- Record explicit constraints (always run quick_validate, minimal diffs, required tooling).
Develop
- List candidate updates: frontmatter description, workflow steps, new resources, or metadata regeneration.
- Prefer minimal-incision improvements; only add resources when they are repeatedly reused or required for determinism.
Deliver
- Implement the chosen changes directly in the target skill; do not invoke
$msseparately. - Keep SKILL.md frontmatter compliant for the target skill (name/description only unless a system skill allows more).
- Regenerate
agents/openai.yamlif stale or missing. - If adding scripts, run a representative sample to confirm behavior.
Validation
Always run quick_validate on the target skill. Example command: uv run --with pyyaml -- python3 codex/skills/.system/skill-creator/scripts/quick_validate.py codex/skills/<skill-name>.
Output Checklist
- Updated
SKILL.mdwith accurate triggers and clear workflow - Updated or regenerated
agents/openai.yamlwhen needed - New or modified resources (scripts/references/assets) if justified
- Validation signal from quick_validate (and script runs if added)
Related Skills
tkersey/invariant-stewardship
testing
VerifiedTrustedCommunity
Use before local patching when bugs, regressions, malformed state, crashes, parser failures, migrations, cache drift, protocol problems, compatibility requests, tolerant readers, fallbacks, coercions, retries, catch-and-continue logic, or local workarounds may broaden accepted invalid state.
60SKILL.mdUpdated Jun 9, 2026
tkersey/evidence-discipline
testing
VerifiedTrustedCommunity
Use for bug reports, PR/issue prose, reviewer comments, user diagnoses, generated summaries, memories, retrieved context, public tracker context, claimed root causes, proposed fixes, fake-minimal repro risk, or any investigation where natural-language context could anchor the implementation scope.
60SKILL.mdUpdated Jun 9, 2026
tkersey/doctrine-compiler
development
VerifiedTrustedCommunity
Use when non-trivial work needs Challenge Escalation, latent-intelligence activation, frame-market selection, doctrine operators, dominant-move selection, ablation/surface-tax judgment, reification, review comment law, negative capability, route receipts, or proof-bearing refusal to mutate.
60SKILL.mdUpdated Jun 9, 2026
tkersey/algebra-driven-design
development
VerifiedTrustedCommunity
Apply Algebra-Driven Design. Use for ADD, denotational design, combinator models, law-driven architecture, domain algebra, property tests, codebase modeling, event sourcing, workflow design, or agentic skill design. If the canonical bundle is unavailable, use this wrapper as the minimal ADD kernel and report the missing bundle path.
60SKILL.mdUpdated May 10, 2026