Canonical: https://aunx-skills.aunysillyme.dev/docs/install/

From [README.md](https://github.com/aunysillyme-dev/aunx-skills/blob/cb7f5439c4047f2bc9b2c311a128c4a5274519fb/README.md) · [cb7f543](https://github.com/aunysillyme-dev/aunx-skills/tree/cb7f5439c4047f2bc9b2c311a128c4a5274519fb) · Built 2026-11-17

# Install Skills

## Install a pack

Copy one folder from `skills/` into your agent's skills directory. Keep its `SKILL.md`, `LICENSE.txt`, and any `scripts/` or `references/` together. Marketplace `listing.md` is for humans and can be left out of an installation.

Agent |  User directory |  Project directory | 

Claude Code |  `~/.claude/skills/` |  `.claude/skills/` | 

Codex CLI |  see your agent's skills documentation |  `.agents/skills/` | 

Cursor |  see your agent's skills documentation |  see your agent's skills documentation | 

Gemini CLI |  see your agent's skills documentation |  see your agent's skills documentation | 

Directory discovery varies by installed agent version and configuration. If your version does not discover a pack automatically, ask the agent to read that pack's `SKILL.md` directly. The instructions work with any agent that can read Markdown; shell helpers and network tools require the separate capabilities stated in each pack.

For example, from this repository:



```
mkdir -p ~/.claude/skills
cp -R skills/number-guard ~/.claude/skills/
```


Then request: "Use Number Guard to calculate this invoice and show the exact and rounded totals."

## Demos and packaging

[Demos](https://github.com/aunysillyme-dev/aunx-skills/tree/main/demos/) contain synthetic sample inputs and actual results. The X Spaces demo demonstrates offline installation and CLI help only. The documentation demo uses local fixtures, so it proves the selection workflow rather than live site access. None of the demos use client records.



```
python3 scripts/check.py
python3 scripts/pack.py
```


The packager writes ten versioned zip files to `dist/`, one per skill. Each zip has an installable folder containing `SKILL.md`, `LICENSE.txt`, and any references or scripts. Listings, logos, and demos remain outside the pack zips. `dist/` is ignored by git. Use `--version 1.0.1` to set a release version. The checker also accepts `--scrub /path/to/private-patterns.txt`, with one case-insensitive regex per non-comment line; keep that file outside the repository. It scans repo text and generated zip members and reports locations without echoing private patterns.

Repository scripts require Python 3.9 or later and its standard library; the checker also uses read-only git file enumeration. The checker reads artifacts and reports every failure with a nonzero exit status. It writes no report files. The packager reads pack files and writes or replaces only the selected version's archives. After editing a pack, rebuild its archives and run the checker with any authorized external scrub list before release. Nothing watches these scripts: the caller starts them and checks their exit codes. `scripts/check.py` and `scripts/pack.py` define their behavior. To regenerate the original logo family, run `python3 scripts/aunx-logos.py` with `rsvg-convert` installed; it writes SVG and PNG files under `logos/`.
