high-quality-skill

Installs an Agent Skills-style package for rigorous, skeptical, expert-level communication.

Install with npx

npx high-quality-skill install

By default this installs into $CODEX_HOME/skills/high-quality when CODEX_HOME is set, otherwise ~/.codex/skills/high-quality.

Useful options:

npx high-quality-skill install --target agents
npx high-quality-skill install --target claude
npx high-quality-skill install --target claude-project
npx high-quality-skill install --target both
npx high-quality-skill install --target all
npx high-quality-skill install --dest ~/.agents/skills/high-quality
npx high-quality-skill install --force

Targets:

• codex: $CODEX_HOME/skills/high-quality or ~/.codex/skills/high-quality
• agents: ~/.agents/skills/high-quality
• claude: ~/.claude/skills/high-quality
• claude-project: ./.claude/skills/high-quality
• both: codex and agents
• all: codex, agents, and claude

Restart Codex, Claude Code, or the target agent after installing so the skill list is refreshed.

What it does

The skill tells the agent to:

• treat the user as an expert
• prioritize truth, precision, and argument quality over agreement
• surface hidden assumptions, failure modes, and strong counterarguments
• maintain Popper/Deutsch-style fallibilist epistemics
• recommend only top-tier, globally excellent products when recommendations matter
• cite sources for factual claims that benefit from verification
• mark proofreading edits inline

Agent compatibility

The package ships one canonical skill folder:

skills/high-quality/SKILL.md

Installers only copy that folder into the directory convention used by each agent. For unsupported agents, use --dest:

npx high-quality-skill install --dest /path/to/agent/skills/high-quality

Local development

npm test
npm pack --dry-run
npm pack

Docker-based npm commands, useful when the host Node/npm environment should not be used:

docker run --rm --user "$(id -u):$(id -g)" \
  -e npm_config_cache=/tmp/.npm \
  -v "$PWD:/workspace" \
  -w /workspace \
  node:24-bookworm npm test

docker run --rm --user "$(id -u):$(id -g)" \
  -e npm_config_cache=/tmp/.npm \
  -v "$PWD:/workspace" \
  -w /workspace \
  node:24-bookworm npm pack

To publish from Docker, pass an npm token:

docker run --rm --user "$(id -u):$(id -g)" \
  -e npm_config_cache=/tmp/.npm \
  -e NODE_AUTH_TOKEN="$NPM_TOKEN" \
  -v "$PWD:/workspace" \
  -w /workspace \
  node:24-bookworm npm publish --access public