sovereign-skills
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 114 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
18 production-grade skills for AI coding agents — setup, scope, discipline, code review, security, session management, governance, ops. Works with Claude Code, Codex, and Cursor.
🌐 English | 한국어 | 日本語 | 中文 | Español
sovereign-skills v6.4
18 skills for the full Claude Code project lifecycle — from setup to daily workflow to code review to session management to governance. Each skill is useful standalone; the full sequence covers everything.
What changed in v6.4: New:
full-audit(exhaustive area audit — deterministic sweep + content review, persistent coverage map, anti-false-positive kill-test),integration-intake(5-item screening gate for adopting external skills/agents/rules/plugins, with a provenance/injection check),clean-room(carves safety-adjacent requests into a safe scope executed by a genuinely isolated fresh-context subagent, adapted from LilMGenius/paperthin's "autobahn" skill under MIT with a filesystem-isolation and ledger-timing upgrade). Updated:goal-lock(a constraint re-echo check at long-task checkpoints, so CONSTRAINTS/SCOPE-Exclude don't quietly fall out of view during extended work),session-checkpoint(a new Attestation phase — an evidence-chain receipt log with a bundledhandoff_attestation.py, so the next session's SessionStart hook can detect handoff tampering).What changed in v6.3: New:
skill-ops(snapshot/rollback + usage health + invocation tracking hub),next-action(reads handoff/git/lessons/STATE and proposes the top-3 next actions),project-overview(deterministic cross-project status map).code-autopsy→ v7.1 (deeper sub-checks per question),pre-push→ v3.5 (9 supply-chain IOC patterns),goal-lock/session-checkpoint/session-start/scope/stepback/freezeall strengthened. All 12 prior skills gainednot_forandsee_alsofrontmatter for better discoverability.
Quick Start
New project (15 min):
/project-init → CLAUDE.md + ROADMAP + .gitignore + .env.example
/setup → rules/ + hooks + memory/ + agent routing + team
then daily:
/session-start at the start of every session
/scope before each feature (define IN/OUT/exit criteria)
/freeze before implementation (declare editable zone)
/goal-lock lock the goal, enforce PLAN→DO→VERIFY loop
/stepback anytime — zoom out, check direction, 10 lines
/next-action anytime — reads current state, proposes top-3 next actions
/code-autopsy 12Q code review with severity scoring + verdict
/pre-push before each push (secrets scan + agent review)
/session-checkpoint at the end of every session
Existing project (5 min):
/project-check → Score across 4 dimensions + gap list by severity
/collab-audit → 14-section AI collaboration diagnostic from your work patterns
Skills
Setup Phase
| Skill | What it does |
|---|---|
| project-init | Interview-based project scaffolding — generates CLAUDE.md, ROADMAP, .gitignore, and .env.example from decisions, not templates |
| setup | Claude Code infrastructure and agent team — rules, hooks, memory, routing, and agent installation in one guided flow |
Daily Workflow
| Skill | What it does |
|---|---|
| scope | Define what's IN, what's OUT, and exit criteria before implementation. Quick mode (3 questions) or Full mode (layered spec) |
| freeze | Declare the editable zone — everything outside is frozen. Prevents scope creep during implementation |
| goal-lock | Agent discipline engine — locks the goal, enforces PLAN→DO→VERIFY→FINALIZE→OUTPUT loop, detects 13 success masquerading patterns |
| pre-push | Mandatory pre-push pipeline — secrets scan (12 patterns), build/test, lint, parallel AI code review. Blocks push on Critical/High findings |
Perspective
| Skill | What it does |
|---|---|
| stepback | Updated. One-shot perspective reset — generates 1 abstract reframing question + 3 quick checks (scope drift, side effects, better approach) in under 10 lines. Use anytime during work |
| next-action | New. Reads handoff/git/lessons/STATE and proposes the top-3 next actions by impact. Proposes only, never executes. Use anytime |
Session Management
| Skill | What it does |
|---|---|
| session-start | Load handoff from last session, review lessons, health check, output "ready" signal with priority action |
| session-checkpoint | Save session context before compact — handoff file, memory updates, lesson extraction, reflexion (what went wrong, what to do differently) |
Code Review
| Skill | What it does |
|---|---|
| code-autopsy | Updated v7.1. 12Q quantified code review — 4-axis scoring (Security/Stability/Robustness/Operability), severity anchors, deployment verdict (SHIP/FIX/RISKY/BLOCK), factuality gate. Backed by empirical evidence (Johnson 2019, Parnas 1972). Also works as a standalone prompt in any LLM |
Quality
| Skill | What it does |
|---|---|
| project-check | Scan existing project across 4 dimensions: Infrastructure, Security, Quality, Harness. Gaps ordered by severity |
| collab-audit | 14-section AI collaboration audit — analyzes your actual work patterns (not surveys) to generate behavioral profile, blind spots, and growth direction |
Operations
| Skill | What it does |
|---|---|
| skill-ops | New. Skill/agent ops hub — snapshot/rollback + usage health + invocation tracking, 3 modes |
| project-overview | New. Generates a deterministic cross-project status map from registered projects' session handoffs |
Governance
| Skill | What it does |
|---|---|
| full-audit | New. Exhaustive audit of an entire area (codebase/docs/skills/memory/config) — deterministic sweep + content review two-layer method, anti-false-positive kill-test, persistent coverage map |
| integration-intake | New. 5-item screening gate for adopting external patterns (skills/agents/rules/plugins/MCP) — redundancy check against your existing assets + a provenance/injection check for imported executable content |
| clean-room | New. Carves safety-adjacent requests into a safe scope, executed by a genuinely isolated fresh-context subagent — adversarial verify pass + descope ledger |
Lifecycle Flow
┌─────────────────── Setup (once) ───────────────────┐
│ /project-init → /setup │
└────────────────────────────────────────────────────┘
↓
┌─────────────────── Daily Loop ─────────────────────┐
│ /session-start │
│ ↓ │
│ /scope → /freeze → /goal-lock → work │
│ → /stepback (anytime) → /code-autopsy │
│ → /pre-push │
│ ↓ │
│ /session-checkpoint │
└─────────────────────────────────────────────────────┘
↓
┌─────────────────── On Demand ──────────────────────┐
│ /stepback (perspective reset — anytime) │
│ /project-check (health audit) │
│ /code-autopsy (12Q code review — any LLM) │
│ /collab-audit (behavioral diagnostic) │
└─────────────────────────────────────────────────────┘
Installation
Option A: Copy skills (simplest)
Each skill is a standalone directory with a SKILL.md file. Copy the ones you want:
# Install all skills
git clone https://github.com/AlexZio00/sovereign-skills.git
cd sovereign-skills
for d in */; do [ -f "$d/SKILL.md" ] && cp -r "$d" ~/.claude/skills/; done
# Or install one skill
cp -r goal-lock ~/.claude/skills/
Option B: Marketplace (sovereign-plugins)
This repo is a Claude Code marketplace. Register it once and browse/install skills:
# Add sovereign-plugins marketplace in Claude Code
# Settings → Plugins → Add Marketplace → https://github.com/AlexZio00/sovereign-skills.git
Each skill also includes standalone .claude-plugin/plugin.json metadata.
Skills are invoked by typing the trigger command (e.g., /goal-lock) in Claude Code. Claude reads the SKILL.md and follows the instructions.
Option C: Codex / Cursor (npx)
Each skill includes agents/openai.yaml for Codex compatibility:
# Install a skill for Codex
npx skills add AlexZio00/sovereign-skills --skill goal-lock --agent codex -g -y
# Install a skill for Cursor
npx skills add AlexZio00/sovereign-skills --skill goal-lock --agent cursor -g -y
# Install a skill for Claude Code (alternative to Option A)
npx skills add AlexZio00/sovereign-skills --skill goal-lock --agent claude-code -g -y
The SKILL.md content is universal — it works with any LLM that reads markdown instructions.
Requirements
- Claude Code: CLI, desktop app, or web app (claude.ai/code)
- Codex: OpenAI Codex with
npx skillssupport - Cursor: Cursor IDE with skill plugin support
- Skills directory:
~/.claude/skills/(Claude Code) or agent-specific path pre-pushrequires Perl (forscan_secrets.pl— included)
Agentic Design Patterns Coverage
These 12 of the 18 skills (the original lifecycle set — the v6.3 operations additions and v6.4 governance additions aren't mapped here yet) implement 17 of the 25 known agentic design patterns (Gulli 2026, Sairahul 2026):
| Pattern | Implemented by | How |
|---|---|---|
| Sequential Pipeline | session-start → scope → goal-lock → pre-push → checkpoint | Full lifecycle chain |
| Parallel Execution | pre-push | Parallel AI code review agents |
| Loop (Retry) | goal-lock | VERIFY fail → PLAN re-entry, capped retries |
| Review & Critique | pre-push, code-autopsy | Independent code-reviewer + security-reviewer; 12Q structured review |
| Iterative Refinement | goal-lock | PLAN→DO→VERIFY→FINALIZE until DONE EVIDENCE passes |
| Coordinator/Router | setup | Agent routing rules generation |
| Plan-and-Execute | goal-lock, scope | Plan reviewable before execution |
| ReAct | project-check | Investigate → score → recommend path |
| Reflexion | session-checkpoint | Phase 1.7: analyze failures → lessons for next session |
| Human-in-the-Loop | goal-lock, pre-push | STOP RULES, Critical/High blocks push |
| Custom Logic | pre-push | Deterministic secrets scan (Perl) + AI review |
| Event-Driven | session-start | Triggered on session open, loads prior state |
| Guardrails/Safety | goal-lock | 13 success masquerading patterns detected |
| Memory Management | session-checkpoint | Handoff file + memory updates + lesson extraction |
| Goal Setting | goal-lock | GOAL + DONE EVIDENCE input sheet |
| Step-Back Abstraction | stepback | DeepMind step-back: concrete → abstract principle |
Design Principles
- Interview over template — Skills ask questions and generate filled content, not empty skeletons
- Verification over trust — DONE EVIDENCE must be executed, not assumed. "It should pass" is not verification
- Scope before code — Define IN/OUT/exit criteria before touching files. Freeze what you're not changing
- Honest reporting — WORKING / PARTIAL / BROKEN labels. No silent brokenness, no mock deception
- Session continuity — Start with handoff, end with checkpoint. Context survives across sessions
How Skills Connect
Skills declare relationships via see_also (related) and not_for
(misuse guardrails) in their frontmatter. Key relationships:
| Skill | Connects to | Relationship |
|---|---|---|
scope |
goal-lock, freeze |
scope defines what to build; freeze locks the editable zone; goal-lock enforces the execution loop |
freeze |
scope, goal-lock |
freeze is the manual zone-lock companion to scope's planning and goal-lock's loop enforcement |
goal-lock |
scope, freeze |
goal-lock is the execution-time discipline layer that scope/freeze set boundaries for |
stepback |
next-action |
stepback checks direction ("am I solving the right problem"), next-action recommends what to do ("what's next by impact") |
next-action |
session-start, stepback |
next-action reads current state for recommendations; session-start restores prior-session state |
session-start |
session-checkpoint |
lifecycle pair — open and close a session |
session-checkpoint |
session-start, setup |
closes a session; setup opens a new project |
code-autopsy |
pre-push |
code-autopsy is a deep, on-demand 12Q review; pre-push runs a faster automated pipeline before every push |
skill-ops |
project-overview |
skill-ops manages skill/agent lifecycle (snapshot/rollback/usage); project-overview aggregates status across multiple projects |
Diagram (arrows = "hands off to" / "informs"):
setup ──> scope ──> freeze ──> goal-lock ──> pre-push
│
stepback (anytime, any stage)
│
session-start <──> session-checkpoint
│
next-action (reads state, recommends)
Changelog
See CHANGELOG.md for the full version history (v3.0 → v6.4).
License
MIT — see LICENSE.
Contributing
Issues and PRs welcome. If you build a skill that fits the lifecycle, open a PR.
Contact
DM @AlexZio00 for custom skill development.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi