Skills
Agent skills that add meaningful value beyond what an unaided model does out of the box, for work that matters to me.
A frontier model is very competent at most things, but its default in any domain is the competent average version of the thing. Each skill here is an effort to drag the model off that median in a chosen direction: narrow, stack-specific disciplines with explicit boundaries and proof obligations.
They carry my taste and intent, stack-specific decisions, failures observed in real work, and the evidence I require before calling work done. The agent gets more specific instructions for the work I care about without putting all of that back into every prompt.
How it fits together
+---------------------------------------------+
| Self-contained skills |
| judgment / boundaries / proof obligations |
+----------------------+----------------------+
|
+---------------+---------------+
v v v
Claude Code Cursor Codex
+---------------+---------------+
|
v
Work in target repository
|
v
Project evidence
source / packages / commands / rendered behavior
The skill supplies the discipline; the target repository supplies the facts. A plugin manifest per agent exposes the same skill source to each of them, while hooks, fixtures, CI, and evaluation tools make broken or stale guidance visible.
Each skill is self-contained. Install the repository once, then let the agent select a relevant skill from the task or name the skill directly.
Use a skill
After installation, start a new agent session so its skill catalog is rebuilt. Then ask normally:
Use improve-layout to repair the mobile overflow without changing the design.
Run openreview across this whole codebase, then plan the selected findings.
Use openreview to implement this named Next.js cache change and re-audit it.
Run quality-audit against this repository and report only verified findings.
Run quality-audit with the launch profile and get this deployment ready.
Run web-launch-checklist for this production release and produce a go/no-go record.
Use ship to commit this change and stabilize the pull request, but do not merge it.
The catalog below is grouped by who decides when a skill runs. Ambient skills apply whenever the work is in their domain, without being asked for. Actions activate from their descriptions when the task matches, or when you name one. Commands only ever run when you invoke them because their cost, timing, or blast radius needs the owner's decision.
The skills inspect and follow the target project's own source, installed packages, components, tokens, and verification commands. Installing this repository does not add a UI runtime, Tailwind configuration, or application dependency to the projects where the skills are used.
Skills
The openreview skill ships the review, planning, implementation, and re-audit workflow, not the openreview-next executable. It runs one initial scan and compacts the JSON report before model review; “whole codebase” changes scan scope, not manual review depth. Full deterministic coverage currently requires a separately provisioned CLI implementing OpenReview DiagnosticReport v1 and its v1 changed-scope comparison envelope. A trusted OpenReview source checkout outside the target may supply its absolute CLI entrypoint and declared runtime when its exact revision is recorded and rules list proves the command surface; the bounded build:scanner CI artifact is not that interface. Until the CLI has a distributable release, installations without either provisioned form must report scanner coverage as Unverified and may perform only clearly labelled advisor work; they must not run a target repository's package script as a substitute.
Install
This repository ships compatible skill metadata for Claude Code, Cursor, and Codex.
Agent Skills CLI
Use the portable installer for Cursor or another supported agent-skills harness:
npx skills add claudialnathan/skills
Codex plugin
Add this repository as an independent Git marketplace, then install the plugin:
codex plugin marketplace add claudialnathan/skills
codex plugin add skills@claudia-skills
Pull later revisions in two steps: refresh the Git marketplace snapshot, then rewrite the installed plugin cache from that snapshot:
codex plugin marketplace upgrade claudia-skills
codex plugin add skills@claudia-skills
Claude Code plugin
This repository is its own claudia marketplace. .claude-plugin/marketplace.json publishes the repository root as a versionless, commit-SHA plugin, so adding the repository is the whole setup:
claude plugin marketplace add claudialnathan/skills
claude plugin install skills@claudia
The same two steps work as /plugin marketplace add and /plugin install inside a session.
Pull later revisions with:
claude plugin marketplace update claudia
claude plugin update skills@claudia
A claudia marketplace registered from anywhere else has to go first, because a name can only be registered once:
claude plugin marketplace remove claudia
Git marketplaces are a Claude Code surface. The Claude apps and claude.ai install plugins through Organization settings > Plugins, which syncs a marketplace repository rather than reading one per user; a plugin distributed that way must keep executables out of a top-level bin/ directory, which this repository does.
Restart the relevant agent after installing or updating. Existing sessions keep the catalog they started with.
Repository systems
This is the source map for the skill library and the machinery around it. Only the skills/ row ships as skill content; nothing else installs itself into a target repository. Use Node 22 for the executable tooling.
| System | What it is | Canonical location | Set up or run |
|---|---|---|---|
| Repository instructions and state | The rules, shared vocabulary, live work queue, one handoff, and settled refusals for this checkout. | AGENTS.md, CLAUDE.md, CONTEXT.md, TASKS.md, HANDOVER.md, .out-of-scope/ | No generator. AGENTS.md owns shared rules and CLAUDE.md imports it; edit the file that owns the fact. |
| Skill source | The portable units shipped by the plugin. Discovery is the flat filesystem, not a manifest list. | skills/ | Add or remove skills/<name>/SKILL.md; no manifest entry is needed. Mark unfinished work with metadata: status: wip. |
| Plugin packaging | Metadata for the portable, Claude Code, and Codex plugin formats, plus both marketplaces this repository publishes itself through. | plugin.json, .claude-plugin/plugin.json, .claude-plugin/marketplace.json, .codex-plugin/plugin.json, .agents/plugins/marketplace.json | Keep the Claude manifest and its marketplace entry versionless and Codex semver-valid. Run scripts/validate-codex-plugin; use the install and update commands above for each harness. |
| Repository gate | The blocking authoring contract, its fixtures, the Claude commit hook, and CI. | scripts/preship-check, tests/preship/, .claude/hooks/preship-gate.sh, .github/workflows/preship.yml | Run scripts/test-preship-check, scripts/test-token-audit, then scripts/preship-check. Pull requests, main pushes, and matching Claude commit attempts run the same set. |
| Tailwind Markdown diagnostics | The official Tailwind language server checking class strings embedded in skill Markdown. | scripts/tailwind-intellisense-check, tooling/tailwind-intellisense.css, tooling/tailwind-language-server/, .vscode/settings.json | Install once with npm ci --prefix tooling/tailwind-language-server --ignore-scripts --no-audit --no-fund; pass touched Markdown paths to the checker, or no paths for all skills. |
| Token measurement | Static, zero-model context measurement plus separately approval-gated model evaluation. | scripts/token-audit, scripts/token-eval, tooling/token-audit/, evals/token-efficiency/ | Run scripts/token-audit --scope changed. Read tooling/token-audit/README.md before any evaluation; token-eval --run requires fresh owner approval and is never part of the default gate. |
ui-preship pilot | A private, advisory UI-evidence package and its reusable GitHub action. | packages/ui-preship/, actions/ui-preship/action.yml, .github/ui-preship-smoke.json | Follow packages/ui-preship/README.md for target-repository setup. Run npm test --prefix packages/ui-preship after changing the pilot. Its publication status and boundaries live in ARCHITECTURE.md. |
| Cross-harness mirrors | Symlinks from this checkout into Cursor, Codex, and repo-local Claude discovery paths. | scripts/sync-cross-tool, skills/ship/references/propagation.md | Preview with scripts/sync-cross-tool --dry-run. Run it only in an authorized ship workflow after a pushed skill change because it writes user-level paths; marketplace caches still need the update commands above after the commit reaches their configured source ref. |
| Optional Claude skill-edit guard | A prompt guard for edits to .claude/skills/ outside this authoring repository. It is not enabled by the checked-in project settings. | .claude/hooks/protect-skills.sh | Owner-level Claude settings may bind it as a PreToolUse hook. Agents report that machine-scope step; they do not write it from this repository. |
| Research and decisions | Durable public design notes, raw machine-local source notes, and ignored scratch evidence. | docs/, .claude/ingest/, working/, .out-of-scope/ | No setup. Promote durable decisions to tracked docs; keep source dumps, approvals, spend records, and temporary evidence in the ignored locations. |