diff --git a/CHANGELOG.md b/CHANGELOG.md index d205380..81e5f0d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ## [Unreleased] +### Added + +- **Claudeception documentation** — Meta-skill for automatic skill generation + - **Repository**: [blader/Claudeception](https://github.com/blader/Claudeception) by Siqi Chen (@blader) + - **What it does**: Monitors Claude Code sessions and auto-extracts discoveries into reusable skills + - **Validated use case**: `pre-merge-code-review` skill auto-generated from debugging workflow + - **Documentation added**: + - `guide/ultimate-guide.md` Section 5.5: "Automatic Skill Generation: Claudeception" (~45 lines) + - `machine-readable/reference.yaml`: `claudeception` + `claudeception_guide` entries + - **Source**: Community contribution via Laurent Dosdat + --- ## [3.11.1] - 2026-01-22 diff --git a/README.md b/README.md index 1a4d5f6..d9f0ebf 100644 --- a/README.md +++ b/README.md @@ -233,6 +233,8 @@ claude-code-ultimate-guide/ **Security Hooks** (15): [dangerous-actions-blocker](./examples/hooks/bash/dangerous-actions-blocker.sh), [prompt-injection-detector](./examples/hooks/bash/prompt-injection-detector.sh), [unicode-injection-scanner](./examples/hooks/bash/unicode-injection-scanner.sh), [output-secrets-scanner](./examples/hooks/bash/output-secrets-scanner.sh)... +**Skills** (1): [Claudeception](https://github.com/blader/Claudeception) — Meta-skill that auto-generates skills from session discoveries ⭐ + **Utility Scripts**: [session-search.sh](./examples/scripts/session-search.sh), [audit-scan.sh](./examples/scripts/audit-scan.sh) **GitHub Actions**: [claude-pr-auto-review.yml](./examples/github-actions/claude-pr-auto-review.yml), [claude-security-review.yml](./examples/github-actions/claude-security-review.yml), [claude-issue-triage.yml](./examples/github-actions/claude-issue-triage.yml) diff --git a/guide/ultimate-guide.md b/guide/ultimate-guide.md index 5d7191b..a7c9ee1 100644 --- a/guide/ultimate-guide.md +++ b/guide/ultimate-guide.md @@ -5093,6 +5093,49 @@ git clone https://github.com/antonbabenko/terraform-skill.git terraform If you create specialized skills for other domains (DevOps, data science, ML/AI, etc.), consider sharing them with the community through similar repositories or pull requests to existing collections. +### Automatic Skill Generation: Claudeception + +**Repository**: [blader/Claudeception](https://github.com/blader/Claudeception) +**Author**: Siqi Chen (@blader) | **Stars**: 1k+ | **License**: MIT + +Unlike traditional skill repositories, Claudeception is a **meta-skill** that generates new skills during Claude Code sessions. It addresses a fundamental limitation: *"Every time you use an AI coding agent, it starts from zero."* + +#### How It Works + +1. **Monitors** your Claude Code sessions via hook activation +2. **Detects** non-obvious discoveries (debugging techniques, workarounds, project-specific patterns) +3. **Writes** new skill files with Problem/Context/Solution/Verification structure +4. **Retrieves** matching skills in future sessions when similar contexts arise + +#### Validated Use Case + +A user reported Claudeception auto-generated a `pre-merge-code-review` skill from their actual workflow—transforming an ad-hoc debugging session into a reusable, automatically-triggered skill. + +#### Installation + +```bash +# User-level installation +git clone https://github.com/blader/Claudeception.git ~/.claude/skills/claudeception + +# Project-level installation +git clone https://github.com/blader/Claudeception.git .claude/skills/claudeception +``` + +See the [repository README](https://github.com/blader/Claudeception) for hook configuration. + +#### Considerations + +| Aspect | Recommendation | +|--------|----------------| +| **Governance** | Review generated skills periodically; archive or merge duplicates | +| **Overhead** | Hook-based activation adds evaluation per prompt | +| **Scope** | Start with non-critical projects to validate the workflow | +| **Quality gates** | Claudeception only persists tested, discovery-driven knowledge | + +#### Why It's Notable + +This skill demonstrates the **skill-that-creates-skills** pattern—a meta-approach where Claude Code improves itself through session learning. Inspired by academic work on reusable skill libraries (Voyager, CASCADE, SEAgent, Reflexion). + ### DevOps & SRE Guide For comprehensive DevOps/SRE workflows, see **[DevOps & SRE Guide](./devops-sre.md)**: diff --git a/machine-readable/reference.yaml b/machine-readable/reference.yaml index 32733a2..c4c2e0d 100644 --- a/machine-readable/reference.yaml +++ b/machine-readable/reference.yaml @@ -102,6 +102,9 @@ deep_dive: design_patterns_skill_stacks: "React, Angular, NestJS, Vue, Express, RxJS, Redux, ORMs" community_skills_cybersec: 4947 community_skills_iac: 5030 + # Automatic skill generation (meta-skill) + claudeception: "https://github.com/blader/Claudeception" + claudeception_guide: 5095 # DevOps/SRE Guide (guide/devops-sre.md) devops_sre_guide: "guide/devops-sre.md" devops_fire_framework: "guide/devops-sre.md:50"