TidyPress ships two readable skills: tidypress for site work and
tidypress-contributor for this monorepo. Installing the npm package does not
install either one.
Explicit command
npx tidypress skills install The compatibility flag tidypress --install-skills invokes the same explicit
operation. No prompt or automatic install runs during npm install, init,
dev, build, preview, or --version.
Detection and destinations
Detection checks for a vendor directory in the user home or an executable on
the supplied PATH. It reads those signals; it does not change them.
| Detected local agent | User destination |
|---|---|
| Cursor | ~/.agents/skills/ |
| Codex | ~/.agents/skills/ |
| Claude Code | ~/.claude/skills/ |
| No supported agent detected | ~/.agents/skills/ neutral fallback |
Cursor and Codex intentionally share the open Agent Skills user directory, so that target is written once when both are detected. Claude Code receives its own documented personal directory. These locations follow the current Cursor skill directories, Codex local-skill locations, and Claude Code personal skill location.
Existing files
Without --force, an existing tidypress/ or tidypress-contributor/ target is
left unchanged. Missing bundled folders are still installed.
npx tidypress skills install --force --force replaces only those two named skill directories. It does not clear the
skills root or touch unrelated skills.
Environment boundary
The installer never writes environment variables, .env files, shell profiles,
agent settings, or project configuration. It does not invoke Cursor, Claude, or
Codex. Detection accepts an injected home and PATH in tests so behavior is
verified without depending on or mutating the machine running the suite.
Source and validation
The authoritative skill sources live in the repository skills/ directory.
Release packaging synchronizes them into the CLI package and tests exact file
equality. Both copies are validated as Agent Skills before release.