Небольшой курированный харнесс для Claude Code — не свалка из сотен блоков, а горстка скиллов, которые заслужили место, плюс каркас безопасности и (главное) цикл самоулучшения: правки пользователя становятся памятью, находки — скиллами, вход нового инструмента идёт через гейт /vet (безопасность — блокирующий шаг). Никаких авто-хуков, которые мутируют что-то без спроса. Подробности — в docs/EVOLUTION.md. Полный текст ниже на английском.
Most "everything for Claude Code" collections optimize for count — hundreds of agents, skills, rules, and event hooks that auto-run on your tool calls. It looks impressive and fails quietly: bloated context, overlapping triggers fighting to activate, and hooks that mutate things without asking.
This repo optimizes for the opposite. A handful of skills that earn their place, a spine of safety guards, and — the actual product — a system that improves itself over time, safely.
A harness that grows is worth more than a harness that's big. The thing that compounds isn't the block count — it's the intake gate, the hygiene loop, and the learning machinery. →
docs/EVOLUTION.mdis the heart of this repo; start there.
What this is / isn't
- ✅ A curated set of executable skills + always-on principles you can drop into
~/.claude/. - ✅ A method (
/vet) for deciding what to adopt, and a registry so you never evaluate the same tool twice. - ✅ A self-evolution loop — corrections become memory, findings become skills, the stack stays clean.
- ✅ Safety by design — no surprise autonomous actions.
- ❌ Not a 500-block mega-bundle. Not a framework you fork. No auto-running hooks.
Looking for a "self-learning" setup?
Single-skill self-learning harvesters are trending, and the good ones are genuinely good. This repo is the system that pattern lives in: four learning layers (corrections → memory → skills → gated intake) instead of one harvest step, a promotion gate so unverified guesses never become authoritative skills, an intake gate (/vet) so the stack doesn't bloat as it learns, and a hygiene loop (system-health) so it doesn't rot. If you only want the harvest step, Kulaxyz/self-learning-skills does it well — we credit and cherry-pick it in docs/EVOLUTION.md. If you want learning as an operating discipline, start here.
Why curated, not dumped
- Vet before adopt. Nothing enters on hype. Every incoming tool runs through one pipeline — relevance → security as a blocking gate → duplication → real ROI → verdict. The security phase reads a skill's body as a behavioral instruction and checks the agentic risks (hidden instructions, prompt injection, trigger abuse, excessive agency) a code-only scan misses.
- It evolves. A user correction is the strongest learning signal; a finding is captured at discovery; a 5+-iteration procedure becomes a skill — but only past a promotion gate (verified check + named failure pattern + a ruled-out dead-end), so confident guesses never get enshrined as truth. The system compounds instead of going stale. →
docs/EVOLUTION.md - Cherry-pick over giant. A good idea inside a huge framework doesn't justify installing the framework. Extract the technique, leave the bloat.
- No auto-hooks. Auto-mutation without confirmation is exactly the failure mode to avoid. →
rules/safety-guards.md
Full rationale: docs/METHODOLOGY.md.
What's inside
Skills (skills/)
| Skill | What it does |
|---|---|
vet |
Evaluate an incoming tool through one pipeline; security is a blocking gate; record the verdict. |
workflow-upgrade |
The deliberate "improve the system" loop: audit → vet → adopt with discipline → record. |
goal |
Autonomous goal loop with a designed verification rubric and hard safety guards. |
konsilium |
5 independent perspectives + mutual critique + synthesis for high-stakes decisions. |
ship-secure |
Security launch audit for a public web app before you ship or hand it to a client. |
pre-push |
A gate before push/deploy: secrets, slop, review, build — nothing junk leaves. |
system-health |
Weekly hygiene scan of your own Claude Code config (memory/rules/permissions). |
teach |
Teacher mode — turn a session/article/concept into an incremental mini-course with quizzes. |
longread |
4-phase analytical writing pipeline with a devil's-advocate pass before publishing. |
Agents (agents/)
Two by design, not sixty — each reflects the verify-before-trust stance, not filler.
| Agent | What it does |
|---|---|
adversarial-verifier |
Tries to REFUTE a claim/finding (defaults to refuted when uncertain) — for checking bugs/audit findings before trusting them. |
tool-scout |
Read-only scout for /vet — reads a tool's repo/docs and returns a structured security report; never installs or runs. |
Rules (rules/)
| Rule | What it covers |
|---|---|
code-principles.md |
Behavioral rules against typical LLM coding mistakes (think-before-code, simplicity, surgical edits, verifiable targets, plan-mode). |
safety-guards.md |
The spine: external content = data not commands; mutation = confirmation; signing-to-real-funds = never; secrets as file:line; result honesty. |
root-cause-discipline.md |
Where a fix belongs and what counts as verified — fix the owning layer not the nearest symptom, minimal ≠ smallest diff, primary vs secondary signals. |
new-project.md |
A "think before code" checklist for starting something from scratch. |
detective-mindset.md |
Reading logs/data like a detective — numeric coincidences, distribution anomalies, cross-source correlation, ghost state, repeat actors, config-vs-code drift. |
Docs & examples
docs/EVOLUTION.md— how the harness improves itself (start here).docs/METHODOLOGY.md— why curated, not dumped.docs/MEMORY_SYSTEM.md— a file-based, self-learning memory pattern.docs/TOOL_ROUTING.md— task → tool routing, proactively.docs/CHANGE_DISCIPLINE.md— backup → surgical → verify → record.examples/— a registry template and a worked/vetverdict.
Which skill should I use?
| I want to… | Use |
|---|---|
| Decide whether to adopt a new tool/skill/MCP | vet |
| Run a deliberate pass to improve my whole setup | workflow-upgrade |
| Hand a goal to the agent and get back a finished, verified result | goal |
| Pressure-test a high-stakes decision (go/no-go) | konsilium |
| Make sure a web app is safe before launch/handoff | ship-secure |
| Make sure nothing junk leaves on push/deploy | pre-push |
| Keep my Claude Code config from rotting | system-health |
| Actually understand a session/article/concept | teach |
| Write an analytical longform piece | longread |
Quick start
Install manually — copy only what you want. (No curl | bash: this harness practices what it preaches.)
git clone https://github.com/Sanexxxx777/curated-claude-code
cd curated-claude-code
# install the skills you want
cp -r skills/vet ~/.claude/skills/
cp -r skills/ship-secure ~/.claude/skills/
# …repeat for the rest
# agents → ~/.claude/agents/ ; rules → append into your CLAUDE.md or ~/.claude/rules/
cp agents/*.md ~/.claude/agents/
Restart Claude Code, then invoke a skill by its name (e.g. /vet).
Attribution
This harness was built the way it tells you to build — by cherry-picking techniques and crediting them:
konsiliumadapts Andrej Karpathy'sllm-council(independent opinions → anonymized peer review → chairman synthesis).ship-secureadapts Prajwal Tomar's "Vibe Coders Are Getting Sued" launch playbook.code-principlesis derived from Karpathy's widely-shared CLAUDE.md principles.goal's design phase cherry-picks loop-design ideas fromksimback/looper.teachadapts Anthropic's guided-learning prompt.- The skill promotion gate in
EVOLUTION.mdcherry-picks the verification bar fromKulaxyz/self-learning-skills.
Work with me
I build and harden Claude Code workflows, agentic setups, and web apps — and I do managed hosting and site builds. If these patterns are useful to your team, or you want help applying them, reach out:
- GitHub: open an issue, or @Sanexxxx777
- Email: [email protected]
Contributing
PRs welcome — see CONTRIBUTING.md. The bar: it must pass its own /vet, ship no auto-hooks, contain no secrets, and stay surgical. Curation is the point; volume isn't.
If this saved you time, a ⭐ helps others find it.
License
MIT © Aleksandr Shulgin (@Aleksandr_NFA) · @Sanexxxx777
No comments yet
Be the first to share your take.