Cc Skills

README

# Agent Skills

AI agent skills are reusable instruction sets that extend your assistant with domain-specific expertise, loaded on demand so they don't bloat your context. This repository covers marketing and engineering skills authored by [@samber](https://github.com/samber).

For Golang-related skills, please visit [cc-skills-golang](https://github.com/samber/cc-skills-golang).

<!-- prettier-ignore-start -->

> [!IMPORTANT]
> Bootstrapped with Claude. **Edited, tested, reviewed and reworked by a human**.
>
> **No AI slop here.** AI-made skills are useless.

<!-- prettier-ignore-end -->

<img width="3808" height="1280" alt="image" src="https://github.com/user-attachments/assets/95139f6f-c19c-4041-a010-d94bca594bba" />

## 🚀 How to use?

**Install with [skills](https://skills.sh/) CLI** (universal, works with any [Agent Skills](https://agentskills.io)-compatible tool):

```bash
npx skills add https://github.com/samber/cc-skills --all
# or a single skill:
npx skills add https://github.com/samber/cc-skills --skill promql-cli
```

<!-- prettier-ignore-start -->

<details>
<summary>Claude Code</summary>

```bash
/plugin marketplace add samber/cc
/plugin install cc-skills@samber
```

</details>

<details>
<summary>Openclaw</summary>

Copy skills into the cross-client discovery directory:

```bash
git clone https://github.com/samber/cc-skills.git ~/.openclaw/skills/cc-skills
# or in workspace:
git clone https://github.com/samber/cc-skills.git ~/.openclaw/workspace/skills/cc-skills
```

</details>

<details>
<summary>Gemini CLI</summary>

```bash
gemini extensions install https://github.com/samber/cc-skills
```

Update with `gemini extensions update cc-skills`.

</details>

<details>
<summary>Cursor</summary>

Copy skills into the cross-client discovery directory:

```bash
git clone https://github.com/samber/cc-skills.git  ~/.cursor/skills/cc-skills
```

Cursor auto-discovers skills from `.agents/skills/` and `.cursor/skills/`.

</details>

<details>
<summary>Copilot</summary>

Copy skills into the cross-client discovery directory:

```bash
/plugin install https://github.com/samber/cc-skills
# or
git clone https://github.com/samber/cc-skills.git ~/.copilot/skills/cc-skills
```

Copilot auto-discovers skills from `.copilot/skills/`.

</details>

<details>
<summary>OpenCode</summary>

Copy skills into the cross-client discovery directory:

```bash
git clone https://github.com/samber/cc-skills.git ~/.agents/skills/cc-skills
```

OpenCode auto-discovers skills from `.agents/skills/`, `.opencode/skills/`, and `.claude/skills/`.

</details>

<details>
<summary>Codex (OpenAI)</summary>

Install the plugin via the Codex CLI:

```bash
codex plugin add github:samber/cc-skills
```

Update with `codex plugin update cc-skills`. Falls back to a manual clone if the marketplace path is unavailable:

```bash
git clone https://github.com/samber/cc-skills.git ~/.agents/skills/cc-skills
```

Codex auto-discovers skills from `~/.agents/skills/` and `.agents/skills/`.

</details>

<details>
<summary>Antigravity</summary>

Clone and symlink into the cross-client discovery path:

```bash
git clone https://github.com/samber/cc-skills.git ~/.antigravity/skills/cc-skills
```

Update with `cd ~/.antigravity/skills/cc-skills && git pull`.

</details>

<!-- prettier-ignore-end -->

## 🧩 Skills

These skills are designed as **atomic units, cross-referencing units**. A skill may reference conventions defined in another. Installing only a subset will give you a partial and potentially inconsistent view of the guidelines. For best results, install all general-purpose skills together.

Each skill lives in `skills/<name>/` with a `SKILL.md` entry point. The `SKILL.md` is kept small with internal references to advanced markdown files, so only the relevant content is loaded into context.

- **Description (tok)**: weight of the `description` field from YAML frontmatter, always loaded into Claude's context for skill triggering
- **SKILL.md (tok)**: weight of the full `SKILL.md` file loaded when the skill triggers
- **Directory (tok)**: weight of all files in the skill directory (SKILL.md + referenced markdown files)

```
                     ┌──────────────┐
                     │ Agent Skills │
                     └───────┬──────┘
                             │
          ┌──────────────────┴──────────┐
          │                             │
          ▼                             ▼
┌────────────────────────┐  ┌──────────────────────────────────────┐
│      Engineering       │  │         Marketing & Content          │
├────────────────────────┤  ├──────────────────────────────────────┤
│ conventional-git       │  │ linkedin-ghostwriting                │
│ promql-cli             │  │ press-release-writer                 │
│ chrome-extension       │  │ humaniseur-fr                        │
│ crxjs                  │  │ humanizer-en-asd-ste100              │
│ site-launch-checklist  │  │ copywriting-hooks                    │
│ frontend-design-deslop │  │ copywriting-cta                      │
│                        │  │ copywriting-prose-creator            │
│                        │  │ copywriting-tone-of-voice-creator    │
└────────────────────────┘  └──────────────────────────────────────┘

┌──────────────────────────┐  ┌───────────────────────────┐  ┌─────────────────────────────────────┐
│   Developer Relations    │  │       Productivity        │  │                Meta                 │
├──────────────────────────┤  ├───────────────────────────┤  ├─────────────────────────────────────┤
│ technical-article-writer │  │ deep-research             │  │ snyk-agent-scan-compliance          │
│ substack-ghostwriting    │  │ influence-and-negotiation │  │ skill-progressive-disclosure-design │
│                          │  │ training-report           │  │                                     │
└──────────────────────────┘  └───────────────────────────┘  └─────────────────────────────────────┘
```

| Skill | Error rate gap | Description (tok) | SKILL.md (tok) | Directory (tok) |
| --- | --- | --- | --- | --- |
| `conventional-git` | -36% | 73 | 1,446 | 1,446 |
| `promql-cli` | -39% | 87 | 1,257 | 6,248 |
| `chrome-extension` | — | 137 | 3,909 | 36,173 |
| `crxjs` | — | 185 | 2,697 | 2,697 |
| `site-launch-checklist` | -59% | 198 | 7,784 | 17,896 |
| `frontend-design-deslop` | -28% | 168 | 4,294 | 45,097 |
| `linkedin-ghostwriting` | -31% | 87 | 1,045 | 1,993 |
| `substack-ghostwriting` | -51% | 154 | 3,416 | 10,821 |
| `technical-article-writer` | -33% | 157 | 2,809 | 6,251 |
| `press-release-writer` | -34% | 159 | 1,686 | 17,981 |
| `humaniseur-fr` | -14% | 166 | 10,782 | 10,782 |
| `humanizer-en-asd-ste100` | -16% | 141 | 9,594 | 9,594 |
| `snyk-agent-scan-compliance` | -27% | 144 | 1,904 | 5,612 |
| `training-report` | -61% | 179 | 2,392 | 8,222 |
| `deep-research` | -51% | 316 | 2,997 | 14,125 |
| `influence-and-negotiation` | -68% | 162 | 6,592 | 48,996 |
| `skill-progressive-disclosure-design` | -58% | 154 | 3,607 | 3,607 |
| `copywriting-hooks` | — | 169 | 6,705 | 13,484 |
| `copywriting-cta` | — | 165 | 2,873 | 14,424 |
| `copywriting-prose-creator` | — | 166 | 4,952 | 24,900 |
| `copywriting-tone-of-voice-creator` | — | 181 | 4,056 | 22,315 |

## 🧪 Skill evaluations

|             | With Skill | Without Skill | Delta     |
| ----------- | ---------- | ------------- | --------- |
| **Overall** | **98%**    | **52%**       | **+46pp** |

See [EVALUATIONS.md](./EVALUATIONS.md) for the full per-skill breakdown.

## 📖 Skills description

### Engineering

#### `chrome-extension`

Chrome Extension development with Manifest V3. Covers architecture, messaging, CSP, storage, permissions, content scripts, service workers, and Chrome Web Store publishing.

#### `conventional-git`

Conventional Commits v1.0.0 for branch naming, worktree naming, and commit messages. Keeps git history parseable for auto-changelogs, SemVer bumps, and issue closing.

#### `crxjs`

CRXJS Chrome extension development with Vite. True HMR for popup/options/content scripts/side panels, `defineManifest` for type-safe manifests, dynamic content script imports.

#### `frontend-design-deslop`

Strategy-first UI design for web frontends, apps, dashboards, and landing pages. Escapes AI-generated generic aesthetics (Inter + indigo + rounded cards) by committing to brand adjectives, then deriving a typography and color system, component state matrices, layout rhythm, motion, iconography, and dark mode. Produces a `DESIGN.md` design token contract.

#### `promql-cli`

CLI for querying Prometheus and PromQL-compatible engines (Thanos, Cortex, VictoriaMetrics, Mimir). Instant/range queries, metric discovery, table/csv/json/graph output.

### Marketing & Content

#### `copywriting-cta`

End-of-article CTA design. Interviews for objective, audience, and context, then produces copy + visual form + mechanism + A/B test plan + accessibility check.

#### `copywriting-hooks`

Opening hooks for long-form articles (blog posts, Substack, LinkedIn long-form, newsletters). Proposes 3-4 hooks with distinct psychological levers: curiosity, contrarian, scene, promise, authority.

#### `copywriting-prose-creator`

Codifies prose mechanics (lexicon, syntax, rhythm, structure) into a PROSE.md style guide. Three modes: BUILD fresh, ADAPT to new channel, AUDIT a corpus. For content factories, ghostwriting teams, house style guides.

#### `copywriting-tone-of-voice-creator`

Builds brand tone of voice guides (TONE.md) with voice attributes, modulation matrix, lexicon, and channel rules. Create from scratch or adapt to a new channel. For B2B, B2C, NGO, public sector, personal brands.

#### `humaniseur-fr`

Removes AI-writing patterns from French text. Detects and fixes 27 patterns: AI vocabulary, anglicisms, formulaic openings, em dash abuse, sycophantic tone, typographic tells.

#### `humanizer-en-asd-ste100`

Rewrites English into ASD-STE100 Simplified Technical English (Issue 9) and de-slops technical document

... (truncated)