mjs-skills

Personal skill library that compounds value over decades. Skills are not tools. They are frozen decisions. Each skill encodes judgment about what matters, what fails, and what works.

---

What This Is

A curated collection of Agent Skills — reusable units of intelligence that teach AI coding agents how to perform specific tasks autonomously.

Each skill encodes:

• What matters here? (focus)
• What can go wrong? (guardrails)
• What is the fastest correct path? (judgment)
• How do I know I’m done? (verification)

---

Philosophy

Traditional: You write code → Code runs → Application works
Agentic:     You write Skills → AI learns patterns → AI writes code → Application works

The bar is higher than MIT, OpenAI, or Google — because this optimizes for personal throughput, context dominance, and problem-to-solution compression, not coordination, publication, or scale.

Core Rule

If two skills plausibly trigger on the same query, at least one is incorrectly designed.

---

Structure

mjs-skills/
├── .claude/
│   ├── skills/                    # The actual skills (22 total)
│   │   ├── meta/                  # Skills about skills
│   │   ├── mcp-powered/           # MCP server wrappers
│   │   ├── infrastructure/        # K8s & cloud
│   │   ├── application/           # Service scaffolding
│   │   ├── ui-patterns/           # Chat & frontend
│   │   ├── integration/           # Connecting services
│   │   ├── devops/                # Deployment & docs
│   │   └── voice/                 # Voice interfaces
│   │
│   ├── hooks/                     # Evaluation & tracking
│   │   ├── track-prompt.sh        # Log user prompts
│   │   ├── track-skill-start.sh   # Detect skill activation
│   │   ├── track-skill-end.sh     # Capture verify.py results
│   │   └── analyze-skills.py      # Weekly usage analysis
│   │
│   └── activity-logs/             # Passive data collection
│       ├── prompts.jsonl
│       └── skill-usage.jsonl
│
├── research/                      # Design documents
│   ├── skill-design-reference.md  # How to build skills
│   ├── h3-skills-master-prd.md    # What skills to build
│   └── skills-evaluation-prd.md   # How to measure value
│
├── spec/                          # Agent Skills Specification
│   └── ...                        # (cloned from agentskills.io)
│
├── CONSTITUTION.md                # Governance principles
└── README.md                      # You are here

---

Skill Anatomy

skill-name/
├── SKILL.md              # YAML frontmatter + instructions (~300 tokens)
├── scripts/
│   ├── verify.py         # Returns 0 (success) or 1 (failure)
│   └── deploy.sh         # Optional: execution script
├── references/           # Optional: deep docs (loaded on-demand)
└── templates/            # Optional: reusable scaffolds

SKILL.md Format

---
name: deploying-kafka-k8s
description: |