# asb-skills

Public Claude Code skills implementing frameworks from
[A Smart Bear](https://longform.asmartbear.com) and
[Hidden Multipliers](https://hiddenmultipliers.com).

Browse the skills at **[skills.asmartbear.com](https://skills.asmartbear.com)**.

## Install the skills

**With the [skills CLI](https://skills.sh)** — installs into Claude Code,
Codex, Cursor, and dozens of other coding agents, and stays updatable:

```sh
npx skills add asmartbear/asb-skills          # all skills (prompts per agent)
npx skills add asmartbear/asb-skills --skill asb-positioning   # just one
npx skills update                             # pull future improvements
```

**As a Claude Code plugin** — this repo is also a plugin marketplace. From
within Claude Code:

```
/plugin marketplace add asmartbear/asb-skills
/plugin install asb-skills@asb-skills
```

Update later with `/plugin marketplace update asb-skills`.

**By hand** — every skill is a single self-contained markdown file at
`.claude/skills/asb-<name>/SKILL.md`; copy it into your own
`~/.claude/skills/asb-<name>/SKILL.md`. A ZIP of all skills and per-skill
copy buttons are on the [install page](https://skills.asmartbear.com/install/).

## Where the skills live

- `.claude/skills/asb-<name>/SKILL.md` — the canonical, single source of
  truth for every **public** skill. No build step, no generated copies; the
  website, the ZIP, the CLI, and the plugin marketplace all serve these exact
  files.
- `dev-skills/<name>/` (no `asb-` prefix) — **dev-only** tooling for working
  in this repo, loaded into local Claude Code sessions via symlinks in
  `.claude/skills/`. Never distributed: the skills CLI doesn't follow
  symlinks, and their frontmatter carries `metadata.internal: true`.
- `.claude-plugin/marketplace.json`, `plugins/asb-skills/` (the Claude Code
  plugin: a manifest plus symlinks to the public skills), and
  `skills.sh.json` — distribution artifacts, generated by
  `bun run gen-manifests`. Don't edit by hand.

## Develop

`bun install`, then see `CLAUDE.md` for commands and the project rules
(especially the public/dev-only skill distinction and the
"kinds of changes" guide).

## License

Skill content is licensed under
[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) (see `LICENSE`) —
reuse freely with attribution to Jason Cohen / A Smart Bear. The website
code in this repo is not separately licensed for reuse.

## Future

Ideas worth doing once the catalog grows or the priority changes. Not
backlog items in any tracked sense — just a parking lot.

- **skills.sh badge.** The repo appears on [skills.sh](https://skills.sh)
  automatically once people install via `npx skills add`; when it does, add
  the install-count badge to this README:
  `[![skills.sh](https://skills.sh/b/asmartbear/asb-skills)](https://skills.sh/asmartbear/asb-skills)`.
- **One section per chapter (plus an "Articles" section).** Not
  categories/tags as such — instead a section per chapter of
  *Hidden Multipliers* for the skills drawn from that chapter, and
  one "Articles" section for skills drawn from A Smart Bear
  articles that aren't in the book. Hold off until we have more
  skills built; it'll be easier to see what this should look like
  with real data, and we want to pile more in before adding the
  structure. (Alternative groupings worth considering when we do it
  — by problem the reader has, or by stage of company.)
- **Sort/filter strip on the home page** (Featured · Newest · All).
  Worth it once there are 6+ skills.
- **"Recently added" rail on the home page.** A single horizontal row at
  the top of the home page surfacing the newest skill (or the next-most-
  recently-updated one). Gives the home page a sense of motion. Useful
  once there's a steady cadence of new skills.

## Future skills

The backlog of skill ideas — each with its source article/chapter citations
ready for forging — lives in [BACKLOG.md](./BACKLOG.md).