@humanjs/skill

Teach your AI coding assistant to write correct HumanJS — humanized Playwright automation. One command drops the skill into your project for Claude Code, Cursor, and/or Codex.

Different from @humanjs/mcp: the MCP server lets an agent drive a humanized browser at runtime; this skill teaches a coding agent to write HumanJS code.

Usage

Run it in your project root:

npx @humanjs/skill

With no flags it asks which tools to set up. Or name them directly:

npx @humanjs/skill --all                  # all three
npx @humanjs/skill --claude --cursor       # pick some

| Flag | Writes | |---|---| | --claude | .claude/skills/humanjs/SKILL.md | | --cursor | .cursor/rules/humanjs.mdc | | --codex | AGENTS.md (merged in place — see below) | | --all | all of the above | | --global, -g | install for every project (your home dir) instead of this one | | -h, --help | usage |

The same instructions go to every target; only the wrapper format and location differ. Re-running is safe — files are overwritten with the latest skill, and AGENTS.md is updated in place.

Global install

Add --global (-g) to install once for every project instead of the current one:

npx @humanjs/skill --global            # prompt, then install globally
npx @humanjs/skill -g --claude --codex # global, specific tools

| Target | Global location | |---|---| | Claude Code | ~/.claude/skills/humanjs/SKILL.md | | Codex | ~/.codex/AGENTS.md (merged in place) | | Cursor | no global rules file — Cursor's user rules live in its settings; install Cursor per-project, or paste the skill into Cursor → Settings → Rules |

AGENTS.md is never clobbered

For Codex, the skill is written into your root AGENTS.md between markers:

<!-- humanjs:start -->
… HumanJS skill …
<!-- humanjs:end -->

If AGENTS.md doesn't exist it's created; if it exists, the block is appended (your content untouched); if the markers are already there, the block is replaced in place. Idempotent.

Non-interactive use

In CI or any non-TTY context the prompt is skipped — pass explicit flags (--all, etc.). Running with no flags and no TTY prints usage and exits non-zero instead of hanging.

Copy-paste instead

Don't want the installer? Grab templates/skill-body.md from this package and drop it where your tool looks:

• Claude Code → .claude/skills/humanjs/SKILL.md (add name + description frontmatter)
• Cursor → .cursor/rules/humanjs.mdc (add description, globs, alwaysApply frontmatter)
• Codex / any tool → paste into your root AGENTS.md

License

MIT