# Your project skills / Free sample

A company's range of expertise, in your repository. This free sample contains six editable skills across six disciplines. Your existing agent chooses the relevant skill for the job; these are instructions and resources, not separately running agents. A sample download contains only the skills listed in its catalog.

## Try an example

Open [the gallery](studio.html), choose a demo and try its main action. Each example shows working source that your agent can adapt with specific skills. For a first task, [check the sample CSV](examples/first-job/index.html), then copy the brief for your own agent.

## Install

1. Extract the download outside the project you want to equip. Open **Open Workshop.html**, then choose **Skills** to open the library.
2. Choose **Choose project** and select your existing project folder. Allow the browser to access that folder, review the proposed changes, then choose **Install**.
3. In your agent, ask it to read `.agents/SKILLS.md` and complete a real task: “Improve this dialog's keyboard behavior and verify focus restoration.”

Folder installation needs a browser with the File System Access API, such as a supported version of Chrome, Edge or Dia. Browser and operating-system permissions may add steps. If the folder picker is unavailable, open the library in a supported browser or use the terminal option below. The installer runs locally; your agent subscription and tools remain separate.

The project receives ordinary, editable files:

```text
.agents/
  SKILLS.md
  skills/<discipline>/<skill-name>/SKILL.md
  examples/
  data/
  SKILLS-LICENSE.txt
  skill-install.json
```

Supporting references and helpers stay with their skills. The installer adds small guide links to `AGENTS.md` and `CLAUDE.md`, preserving existing text. It can add adapters for other tools it detects. Codex and Cursor can discover the shared skills natively; Claude Code follows the project guide. No global installation is needed. See [COMPATIBILITY.md](COMPATIBILITY.md) for the distinction.

The complete library from your download is installed, including linked examples and data. The browsing page and installer interface stay in the download. No skill name needs a brand prefix. Edit the files directly and commit them with your project.

## Yours to adapt and share

Use the skills in unlimited personal, company and client projects, including commercial work. You may include them in public or private project repositories; collaborators and recipients can use the included skills for those projects without buying seats. Keep the supplied license and third-party notices. Selling or redistributing a standalone skill collection is outside this permission. Read [LICENSE.txt](LICENSE.txt) for the complete terms.

The master guide, [SKILLS.md](SKILLS.md), explains how to choose a small working set and finish the requested work. You can adapt that guide too.

## Terminal option

With Python 3.10 or newer, run this from the download's **Library** folder:

```sh
python3 scripts/install.py --target /path/to/your-project --dry-run
python3 scripts/install.py --target /path/to/your-project
```

Replace the path with your existing project folder and quote it if it contains spaces. On Windows, use `python` if that is your Python 3 command. The first command previews the plan; the second installs it.

To remove an automatic installation:

```sh
python3 scripts/install.py --target /path/to/your-project --uninstall --dry-run
python3 scripts/install.py --target /path/to/your-project --uninstall
```

## Preserve your changes

Existing conflicts and edited installed files are preserved. Resolve a reported conflict deliberately; do not delete an edited file just to make installation proceed. Keep `.agents/skill-install.json`: it records the installation and contains the original instruction-file bytes used for restoration. Uninstall removes unchanged installed files and restores the recorded originals; it stops if your changes would be lost. Use one installer at a time.

For a pre-2.1 installation under `.rival/workshop`, the new installer blocks a second installation. Use the terminal uninstall command to remove the old installation first. Edited legacy files require a deliberate migration; the installer does not silently delete them.

## Manual installation

Copy `SKILLS.md`, `skills/`, `examples/` and `data/` into your project's `.agents/` directory, keeping their relative layout. Copy `LICENSE.txt` there as `SKILLS-LICENSE.txt` and retain the third-party notices inside the examples. Append the appropriate snippet from [adapters/](adapters/README.md) to your existing instruction file. Do not replace existing project instructions.

Manual copies have no automatic uninstall journal. Reconcile an existing manual copy before using an automatic installer.

## Explore the examples

Open [the gallery](studio.html) or [the source guides](examples/README.md). The five gallery demos open directly from disk; the material renderer is bundled. For reliable storage, clipboard and graphics behavior when file restrictions apply, run this from **Library**:

```sh
python3 -m http.server 8080 --bind 127.0.0.1
```

Visit `http://127.0.0.1:8080/`. Use the Python installer above when the browser's folder picker is unavailable, including in Safari.

This is a fixed download, with no hosted agent, professional services or promised future updates.