# Vendored agent skills

These skills are vendored copies, not submodules. `link-ai-configs.sh` links every
directory here into `~/.omo/agent/skills/`, and all of them except
`frontend-workflow` into `~/.claude/skills/`, so OmO and Claude Code read one
canonical source instead of divergent copies.

They moved here from `.config/opencode/skills/` when OpenCode was retired; the
OpenCode-era evaluation notes and rollback steps are in git history at
`.config/opencode/README.md`.

## Provenance

| Skill | Upstream | Revision | License |
|---|---|---|---|
| `impeccable` | [pbakaus/impeccable](https://github.com/pbakaus/impeccable) (`.opencode` integration, tag `skill-v4.6.0`, engine 0.1.15) | `8a0e198da34ebc5b936a9d5975fb7a3b1cf353b7` | Apache 2.0, included |
| `web-design-guidelines` | [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) (`skills/web-design-guidelines/SKILL.md`) | `063bee94c3f4df8453406c830b0a7df0f2860278` | per upstream |
| ten marketing and copy skills | [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) (`skills/`) | `b9ba399dd88b082b926e261e8ccfb843d20aa066` | MIT, copied into each skill |
| `frontend-workflow` | local | - | - |
| `sound-design` | local | - | - |

The ten marketing skills are `product-marketing`, `copywriting`, `copy-editing`,
`emails`, `cold-email`, `content-strategy`, `seo-audit`, `ai-seo`, `launch` and
`social`.

## Local modifications

- **`impeccable`**: every `.opencode/skills/impeccable/scripts/impeccable` command
  path was rewritten to `~/.omo/agent/skills/impeccable/scripts/impeccable`,
  including the `allowed-tools` Bash entry and the base-directory fallback in
  `SKILL.md`. Without this the detector and live-server verbs do not resolve under
  OmO. `reference/critique.md` also carries an OmO routing line that sends
  Assessment A to the `design-critique-a` category and Assessment B to
  `design-critique-b` (defined in `.config/omo/omo.jsonc`). `LICENSE` comes from the
  upstream repository root, because the `.opencode` directory ships without one. The
  engine binary is not vendored: on first run, `scripts/impeccable` downloads the
  version named in `scripts/VERSION` into `~/.impeccable/bin/<version>/` and checks it
  against the published checksum.
- **`web-design-guidelines`**: unchanged. It fetches the current
  [Web Interface Guidelines](https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md)
  when invoked, so its rule feed is intentionally not pinned.
- **marketing skills**: unchanged. They read a per-project
  `.agents/product-marketing.md` for product context, and a project's own copy
  skill overrides their generic direct-response advice. Links to the upstream
  repo's top-level `tools/` directory were not vendored and resolve to nothing.

## Upgrading

Re-copy the same directories from a newer upstream revision, update the revision
in the table above, then re-apply the local modifications listed for that skill
and rerun `link-ai-configs.sh`. For `impeccable`, re-apply the path rewrite:

```bash
cd .config/omo/skills/impeccable
rg -l -F '.opencode/skills/impeccable/scripts' . \
  | xargs sed -i '' 's#\.opencode/skills/impeccable/scripts#~/.omo/agent/skills/impeccable/scripts#g'
```

This pattern also covers the base-directory fallback in `SKILL.md`, which ends at
`scripts` rather than `scripts/impeccable`. Keep `LICENSE` when re-copying (for
example `rsync -a --delete --exclude LICENSE <upstream>/.opencode/skills/impeccable/ .`),
and re-add the OmO routing line after the "Delegate Assessment A and Assessment B"
paragraph in `reference/critique.md`.