# Agent skills

The CLI installs three [Agent Skills](https://agentskills.io) that teach your agent when and how to use JustClaw-It. They go into Claude Code (`~/.claude/skills`), OpenClaw (`~/.openclaw/skills`) and Hermes (`~/.hermes/skills`). Skip them with `--no-skills`.

## justclaw-it-search

Search before writing anything a thousand projects already have: auth middleware, OAuth flows, payment webhooks, rate limiters, uploads, email senders, retry logic, data tables, API clients, CLI scaffolds. It tells the agent to:

1. call `search_components` with a short query naming the job and the stack;
2. pick by **fit** first (same language and framework, similar scope), then **quality** (`scores.composite`; null means unscored), then **licence**: permissive is fine, copyleft only if the project's licence is compatible, never code without a licence;
3. pull the chosen one with `get_component` and adapt it to the codebase;
4. not repeat the same search in one task.

## justclaw-it-pull

Pull a component (or a Pro bundle) into the project properly:

1. fetch with `get_component`, or `get_component_bundle` on Pro;
2. **check the licence before writing anything** (`license_spdx`, `resell_class`, `copyleft_flag`);
3. place it like local code: the project's naming, module system, formatter and types; delete what isn't used;
4. **attribute it**: keep the header in every file and record the component in `THIRD_PARTY_LICENSES`;
5. wire in the dependencies it needs.

## justclaw-it-starter (Pro)

Compose a new project with `compose_starter`: pin down the stack and features, compose, review the chosen components and their licences with you, write the project with every attribution header, README credits and NOTICE file, then install, build and fix the glue until it runs. Without Pro it falls back to search plus pull for each piece.

## Install them by hand

The skill folders (`justclaw-it-search`, `justclaw-it-pull`, `justclaw-it-starter`) ship inside the `@justclaw-it/cli` npm package, under `skills/`. Copy them into your agent's skills directory. Any agent that reads Agent Skills can use them, as long as the `justclaw-it` MCP server is configured.