tituskirch/skills

# GitHub Repository: TitusKirch/skills

**URL:** https://github.com/TitusKirch/skills
**Author:** TitusKirch
**Description:** Agent skills by Titus Kirch — installable via skills.sh in Claude Code, Cursor, Windsurf and friends.
**Homepage:** 
**Language:** JavaScript

## Stats
- Stars: 0
- Forks: 0
- Open Issues: 4
- Commits: 109
- Created: 2026-05-22T15:37:43Z
- Updated: 2026-06-21T23:26:40Z
- Pushed: 2026-06-21T23:26:54Z

## README
<div align="center">

# 🧩 skills

**Agent skills by Titus Kirch — installable via [skills.sh](https://skills.sh) in [Claude Code](https://docs.claude.com/en/docs/claude-code/overview), Cursor, Windsurf and friends**

[![skills.sh](https://skills.sh/b/TitusKirch/skills)](https://skills.sh/TitusKirch/skills)
[![Tests](https://img.shields.io/github/actions/workflow/status/TitusKirch/skills/ci.yml?branch=main&style=flat-square&label=tests)](https://github.com/TitusKirch/skills/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/github/license/TitusKirch/skills?style=flat-square&color=10b981)](LICENSE)

</div>

---

```bash
npx skills add TitusKirch/skills        # npm
pnpm dlx skills add TitusKirch/skills   # pnpm
yarn dlx skills add TitusKirch/skills   # yarn
bunx skills add TitusKirch/skills       # bun
```

That's it. Every skill in this bundle is now discoverable inside Claude Code — no manifest editing, no symlink dance.

## ✨ Features

- **🧩 Self-contained skills** — each folder under `skills/` ships a `SKILL.md` (YAML frontmatter + body) plus optional templates, references and scripts. No runtime code.
- **🛡️ Lint-clean by construction** — `oxlint` + `oxfmt` (markdown-first) gated by husky + commitlint + lint-staged. CI runs the same checks.
- **🔁 Three install paths** — `skills.sh` CLI for users, `pnpm skills:link` for live local dev, hand-copy for one-off picks.
- **📋 House-style enforced** — the [`write-readme`](skills/write-readme/SKILL.md) skill prescribes the README layout, section emojis and badge palette so every kirchDev repo looks the same.
- **🚀 Release-please ready** — Conventional Commits drive automated versioning + CHANGELOG via release-please on `main`.

## 🧩 Available skills

<!-- skills:start -->
<!-- Generated by `pnpm skills:sync` — edit skill frontmatter, not this table. -->

| Skill                                              | Description                                                                                   |
| :------------------------------------------------- | :-------------------------------------------------------------------------------------------- |
| [`atomic-commit`](skills/atomic-commit/SKILL.md)   | Commits session work as atomic Conventional Commits (or just plans).                          |
| [`compact-readme`](skills/compact-readme/SKILL.md) | Slims down an existing overstuffed README without losing information.                         |
| [`issue`](skills/issue/SKILL.md)                   | Creates/updates/searches issues across GitHub (gh) or Linear (MCP), backend chosen by config. |
| [`pull-request`](skills/pull-request/SKILL.md)     | Opens a pull request from the current branch via gh; backend chosen by config (github in v1). |
| [`vhs-demo`](skills/vhs-demo/SKILL.md)             | Creates & maintains a reproducible terminal-demo GIF from a VHS tape.                         |
| [`write-docs`](skills/write-docs/SKILL.md)         | Scaffolds, extends and reconciles a project's docs/ tree in the TitusKirch docs format.       |
| [`write-readme`](skills/write-readme/SKILL.md)     | Generates project READMEs in the kirchDev house style.                                        |

<!-- skills:end -->

## 📦 Installation

### Option A — `skills.sh` CLI (recommended for users)

```bash
npx skills add TitusKirch/skills        # npm
pnpm dlx skills add TitusKirch/skills   # pnpm
yarn dlx skills add TitusKirch/skills   # yarn
bunx skills add TitusKirch/skills       # bun
```

Set `DISABLE_TELEMETRY=1` to opt out of the CLI's anonymous install-count telemetry.

### Option B — symlink locally (recommended when developing on this repo)

```bash
git clone https://github.com/TitusKirch/skills.git
cd skills
pnpm install
pnpm skills:link        # symlinks every skill into ~/.claude/skills/
pnpm skills:list        # lists every SKILL.md in the repo
pnpm skills:unlink      # removes only the symlinks pointing back into this repo
```

Restart Claude Code (or run `/reload-plugins`). Because the skills live as symlinks, edits in the working copy are picked up live.

### Option C — install a single skill by hand

Copy one skill folder into:

- **User scope** — `~/.claude/skills/<skill-name>/` (available in every project).
- **Project scope** — `.claude/skills/<skill-name>/` (committed alongside the consuming project).

## 🚀 Quick start

Once installed, invoke a skill by name or trigger phrase. The `write-readme` skill, for example, activates on prompts like:

```text
/write-readme draft a README for my new Laravel package
```

Claude Code picks the right skill based on the `description:` field in each `SKILL.md` — write that field tight and the agent will route correctly.

## ➕ Adding a new skill

Drop a `skills/<name>/SKILL.md`, run `pnpm skills:sync` — it regenerates the table above and [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json) from the frontmatter — then commit as `feat(<name>): add skill`.

See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the full workflow and [`skills/README.md`](skills/README.md) for the frontmatter contract.

## 💡 Inspiration

The local `pnpm skills:link` / `:list` / `:unlink` scripts are modelled on [mattpocock/skills](https://github.com/mattpocock/skills).

## 🤝 Contributing

PRs welcome. Conventional Commits required (enforced via commitlint). Husky runs `oxlint` + `oxfmt` on `git commit` — primarily on markdown, since that's what skills are made of.

> [!TIP]
> Run `pnpm check:fix` before pushing — CI will catch what husky missed.

See [`CONTRIBUTING.md`](CONTRIBUTING.md) and [`SECURITY.md`](SECURITY.md).

## 🛣️ Versioning

[Semantic Versioning](https://semver.org/) via [release-please](https://github.com/googleapis/release-please) — see [CHANGELOG.md](CHANGELOG.md).

## 📄 License

[MIT](LICENSE) © [Titus Kirch](https://github.com/TitusKirch/) / [IT-Dienstleistungen Titus Kirch](https://kirch.dev)