# Install the Rod Loom agent skill

Teach your agent to design a fishing-rod thread wrap, choose real catalog threads, inspect a preview, revise the pattern, and return an editable share link.

## Install

With Node.js and npm available, use the Skills CLI:

```sh
npx skills add jaywolters/rodloom-skills --skill rodloom
```

Choose your agent and installation scope when prompted. Add `--agent claude-code` or another supported agent identifier to select a client explicitly. Use `--global` only if you want a user-wide installation; the default installation is project-local. Review any installation prompt before approving it.

View the [Skills.sh listing](https://skills.sh/jaywolters/rodloom-skills/rodloom).

The source is [`skills/rodloom/SKILL.md`](https://github.com/jaywolters/rodloom-skills/tree/main/skills/rodloom). You can inspect the [published SKILL.md](/skills/rodloom/SKILL.md) and its [MCP setup](/skills/rodloom/references/mcp-setup.md), [workflow reference](/skills/rodloom/references/workflow.md), and [example design](/skills/rodloom/references/example-design.json) before installing.

To discover the skill without installing it:

```sh
npx skills add jaywolters/rodloom-skills --list
```

For a manual installation, copy the **whole `skills/rodloom/` directory**, including its `references/` files, into your client's supported skills location. Copying only SKILL.md loses the setup guide and example. Installation does not require cloning the entire Rod Loom app or installing its Python backend.

## Connect MCP separately

A skill supplies instructions. **It does not automatically connect MCP, grant tool permissions, or enable vision.** Follow the bundled [client setup guide](/skills/rodloom/references/mcp-setup.md) or [hosted MCP guide](mcp.md).

- Server URL: `https://304heq9dze.execute-api.us-west-2.amazonaws.com/mcp`
- Transport: Streamable HTTP
- Tool: `preview_design`
- Authentication: none; do not submit sensitive information.

Claude Code users can add the server with:

```sh
claude mcp add --transport http rodloom https://304heq9dze.execute-api.us-west-2.amazonaws.com/mcp
```

Cursor users can merge a `rodloom` entry with that URL into the project's `.cursor/mcp.json`; see the setup guide for the full example. Other clients have different configuration formats and approval scopes. The skill instructs the agent not to change settings without permission.

Use an image-capable model and a client that forwards MCP image content. Otherwise, the skill includes a download-and-open HTTP fallback and requires the agent to label unseen results **unpreviewed**.

## Try it

> Use the Rod Loom skill to design a gold-and-green fishing rod wrap, Size D, approximately 30 mm wide on a 15 mm blank. Choose real catalog threads, render and inspect the rod and flat views, revise if needed, and give me an Open in Rod Loom link. Tell me whether you actually saw the preview.

The skill guides the agent to:

1. Establish the theme, measurements, and assumptions.
2. Select real Fuji or ProWrap catalog identities and illustrative preview colors.
3. Build full design JSON for solid bands and paired spirals.
4. Call `preview_design`, read validation and warnings, inspect the native image, and revise.
5. Generate an editable share link or provide a JSON fallback for oversized designs.

Rendering does not save a design online, and validation is not an aesthetic score. Colors, dimensions, and thread consumption remain estimates; inspect physical samples and allow waste. Rod Loom does not simulate decorative cross wraps or guide-foot clearance.

## Discovery and updates

The skill lives in the public `jaywolters/rodloom-skills` repository's standard `skills/rodloom/` directory so skill-aware clients and the Skills CLI can discover it. The application repository remains private; the public repository contains only the skill, its references, and a README. It is also linked from the Wrap guide modal, [llms.txt](/llms.txt), and the [agent quickstart](quickstart.md). Availability in third-party search directories and their indexing timing are controlled by those directories, not Rod Loom.

To refresh an installed copy using the Skills CLI:

```sh
npx skills update rodloom
```

Choose the appropriate project or global scope when prompted. Review updates before executing any new instructions. The public [authoring guide](design-guide.md), [MCP guide](mcp.md), and [share-link contract](share-links.md) remain available without installing the skill.
