# SVG Local Assets

This directory contains the controlled local SVG asset libraries available to
the SVG skill.

## Scope

The local catalog is limited to:

- `assets/libraries/lucide`: Lucide icons as a pinned Git submodule.
- `assets/libraries/open-peeps`: Open Peeps SVG files vendored directly
  from the official Open Peeps website.

No third library is currently declared. Illustration composition workflows and
remote fetching at runtime remain out of scope for this asset catalog.

## Index

`skills/svg/assets/index.json` is generated by:

```bash
node scripts/build-svg-asset-index.js
```

Do not edit the index manually. Validate it with:

```bash
node scripts/check-svg-asset-index.js
```

Search the index with:

```bash
node skills/svg/tools/search-assets.js --query "save icon" --kind icons --limit 5
```

The index is a discovery and anti-drift artifact. It does not duplicate full
upstream metadata. Library metadata is sourced from
`skills/svg/assets/libraries-catalog.json` by the build/check scripts.

`scripts/build-svg-asset-index.js` and `scripts/check-svg-asset-index.js` are
repository maintenance commands. Agents using an installed skill should prefer
the bundled `tools/search-assets.js` helper for discovery.

## Update Policy

- Update Lucide only through an explicit submodule update window.
- Update Open Peeps only from the official Open Peeps website or an approved
  local archive derived from that source.
- After every update, rebuild the index, run the local asset smoke checks, and
  verify SVG skill smoke checks for regression.
- If an upstream folder structure changes, update the indexer and checks in
  the same change.

## License Notes

License and attribution metadata live in `skills/svg/assets/licenses/`.

The current local asset sources are:

- Lucide: `https://github.com/lucide-icons/lucide`
- Open Peeps: `https://www.openpeeps.com/`