A growing collection of agent skills from my work on ViteHub, Nuxt, auth, validation, Nimiq, and AI coding tools.
npx skills add onmax/skills
These skills are meant to compose into a lightweight delivery loop:
| Phase | Artifact | Main skills |
|---|---|---|
| Clarify direction | Shared understanding, vocabulary, maybe an ADR | design-to-agent-work, grill-with-docs, evidence-research, codex-session-finder, handoff |
| Capture durable memory | .agents/CONTEXT.md terms and atomic ADRs |
grill-with-docs, validate-direction |
| Shape agent work | GitHub issues as executable work contracts | shape-agent-work |
| Run agents | Branches and PRs from autonomous work | sandcastle, sandcastle-workflow, vps-connection, pr-body |
| Refine PRs | Autonomous PR cleanup and checks | sandcastle-workflow, pr-refiner, pr-body |
| Check merge readiness | Autonomous consumer-facing proof before merge | sandcastle-workflow, pre-merge-validation, pr-stack-coordinator |
| Merge command | Consent-gated rebase/squash/merge execution | pr-stack-coordinator |
validate-direction is not a phase. Use it whenever a direction is about to harden into docs, issues, code, PR strategy, or merge action.
The first workflow iteration keeps GitHub labels intentionally small:
| Label | Meaning |
|---|---|
needs-info |
The issue is not executable yet. |
ready-for-agent |
The issue has enough context and acceptance criteria for autonomous work. |
in-agent-run |
Sandcastle or remote Codex is actively working on it. |
blocked |
Execution cannot continue without a human decision, access, dependency, or repo-state fix. |
When an autonomous run succeeds, it opens a PR with automatic issue linking such as Closes #123, refines the PR, runs needed merge-readiness validation, removes in-agent-run, and intentionally leaves the open issue without a workflow label. The issue stays open until the PR merges.
| Skill | What it does |
|---|---|
codex-session-finder |
Finds local Codex sessions for review. |
evidence-research |
Researches internal or external evidence for a decision. |
design-to-agent-work |
Orchestrates direction clarification, durable memory, and agent-ready issue shaping. |
fast-forward |
Skips obvious branches during grilling sessions. |
grill-me |
Interrogates a plan one decision at a time. |
grill-with-docs |
Stress-tests a plan and captures project language. |
handoff |
Captures continuation notes for another agent or session. |
library-craft |
Reviews reusable package shape and public API craft. |
people-skills |
Drafts relationship-preserving messages and interpersonal next actions. |
pr-body |
Writes or reviews PR bodies in the repository's preferred style. |
pr-refiner |
Reviews PR blockers and routes the next refinement step. |
pr-stack-coordinator |
Coordinates stacked PRs, worktrees, ADR indexes, merge commands, and per-PR merge confirmation. |
pre-merge-validation |
Runs consumer-install validation before merging PRs. |
sandcastle |
Explains and applies Sandcastle concepts for isolated agent execution. |
sandcastle-workflow |
Runs ready-for-agent issues through Sandcastle or remote Codex and opens linked PRs. |
shape-agent-work |
Converts clarified direction into GitHub issues for autonomous agents. |
simplify |
Finds the smallest useful simplification for a PR or scope. |
setup-onmax-skills |
Sets up lightweight repo-local guidance for Onmax skills. |
codex-skill-retrospective |
Reviews Codex sessions and GitHub activity to improve skills. |
strict-code-review |
Runs a strict maintainability review for structural quality and code-judo simplifications. |
validate-direction |
Challenges a direction before it becomes a plan or doc. |
worktree-cleanup |
Safely cleans current-repo worktrees, stale branches, remote workspaces, and disk-heavy artifacts. |
write-a-skill |
Creates agent skills with proper structure and review checks. |
vps-connection |
Discovers and verifies VPS/SSH access and remote Codex helpers. |
Use worktree-cleanup from the repo you want to clean:
Use worktree-cleanup here. Clean this repo locally, then clean the shared VPS workspace if relevant. Preserve dirty, untracked, or unique local work and report it first.
The skill defaults to the current session repository for manual cleanup. Daily automation can broaden the scope to common local roots and /home/workspace on the VPS.
These skills build on patterns and ideas from:
