marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: add Claudeception meta-skill documentation

Browse source 
Add documentation for blader/Claudeception - a meta-skill that
auto-generates skills from Claude Code session discoveries.

Changes:
- guide/ultimate-guide.md: New section 5.5 "Automatic Skill Generation"
- machine-readable/reference.yaml: claudeception + claudeception_guide entries
- README.md: Add Skills category with Claudeception reference
- CHANGELOG.md: Document addition in Unreleased

Source: Community contribution via Laurent Dosdat

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX 2026-01-22 20:46:19 +01:00
parent 3841b9bfb8
commit 76762b5ab3
4 changed files with 59 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

43
guide/ultimate-guide.md
View file

@ -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)**: