cc-skills
AI Agent Skills
Open source Open in the app JSON README (API)
About
AI Agent Skills
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- samber
- Origin
- gemini
- Category
- ferramentas
- Version
- 2.4.0
- Stars
- 201
- Forks
- 15
- Open pull requests
- 1
- Last push
- 2026-09-05T01:01:11Z
- Repository state
- ativo
- Language
- CSS
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-09-03 02:00:26
- Origin id
samber/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>
Clone into the cross-client discovery path:
```bash
git clone https://github.com/samber/cc-skills.git ~/.agents/skills/cc-skills
```
Codex auto-discovers skills from `~/.agents/skills/` and `.agents/skills/`. Update with `cd ~/.agents/skills/cc-skills && git pull`.
</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 documentation — decorative emojis, conversation leftovers, Markdown residue, mixed quote styles. Enforces the 53 rules across 9 sections — approved word meanings, technical noun/verb categories, sentence-length limits, banned verb tenses, passive-voice restrictions — for maintenance manuals, equipment procedures, and any technical text read by non-native speakers or machine translation.
#### `linkedin-ghostwriting`
B2B LinkedIn ghostwriting via strategic interview, hook engineering, and post body. Turns founder stories and results into conversion-focused posts.
#### `press-release-writer`
Professional press releases for any occasion and region. Product launches, funding, partnerships, crisis, M&A, events. Region-specific conventions (Europe, Americas, Asia, etc.).
#### `site-launch-checklist`
Pre-launch checklist for shipping a website. Analytics (GA4, PostHog, GSC), legal, security headers, SEO/GEO, copywriting pass, OpenGraph, favicons, Lighthouse, accessibility. Opinionated for Cloudflare + Vercel.
### Developer Relations
#### `substack-ghostwriting`
Write, optimize, and grow Substack newsletters and articles. Covers topic selection, headline optimization, SEO, and audience building.
#### `technical-article-writer`
Technical articles and blog posts for senior developers. Opinionated, practical, example-driven content that teaches something or saves time.
### Productivity
#### `deep-research`
Deep research with parallel web searches, multi-source validation, and cited Markdown reports. 11 research types: market, competitive, technical, academic, financial, legal, trend, community, and more.
#### `influence-and-negotiation`
Negotiation and influence toolkit for any interaction requiring agreement. B2B sales, salary, collective bargaining, hard 1:1s, recruitment, cross-cultural deals. Preparation, live coaching, and diplomatic drafting.
#### `training-report`
Generates structured training reports from session data. Tracks progress, skills acquired, and outcomes.
### Meta
#### `skill-progressive-disclosure-design`
Design patterns for skill progressive disclosure. Structures skill content for lazy loading so only relevant sections enter context.
#### `snyk-agent-scan-compliance`
Compliance expert for snyk-agent-scan. Validates security scan configurations and ensures compliance with organizational policies.
## 🎯 Tuning Skill Triggers
If a skill triggers too often or not often enough, please [open an issue](https://github.com/samber/cc-skills/issues) suggesting a description change. The `description` field in SKILL.md frontmatter is the primary triggering mechanism: small wording adjustments can significantly improve trigger accuracy. Some `SKILL.md` might have a `When to use` section which is another level of exclusion. Finally, `SKILL.md` is an entrypoint for lazy loading references with deep knowledge located in `references/`.
## 🔄 Overlap
If your team has its own conventions, create a company skill and declare the override explicitly near the top of its body: `This skill supersedes samber/cc-skills@git-convention skill for [company] projects.`
## ✍️ Contribute
- **100 tokens per skill description** - what? when to use this skill?
- **1.000–2.500 tokens per SKILL.md** — keep the main file focused on essentials
- **Use secondary markdown files for depth** — reference them from SKILL.md with relative links (e.g., `[Logging](./logging.md)`). Claude reads these on demand when the topic is relevant, so they don't count against the context budget until needed
- **Up to 10.000 tokens** for full skill and secondary files
- **2–4 skills loaded simultaneously** in a typical session — design skills to coexist
- **Stay below ~10k tokens of total loaded SKILL.md** anytime to avoid degrading response quality
For more guidelines, please check `CLAUDE.md`.
## 💫 Fuel the Revolution
- ⭐️ **Star this repo** - Your star powers the caffeine engine!
- ☕️ **Buy me a coffee** - I'll literally use it to build more skills while drinking actual coffee
[](https://github.com/sponsors/samber)
## 📝 License
Copyright © 2026 [Samuel Berthe](https://github.com/samber).
This project is under [MIT](./LICENSE) license.