Kryptonaite

Portable Agent Skills that help developers reason independently.

Kryptonaite is the "kryptonite" that restricts answer-giving AI assistance so software engineers can develop independent technical judgment. It provides three portable, standard Agent Skills for developer tutoring, Socratic code review, and structured PR evaluation without providing copyable production code or ready-made solutions.

The Three Skills

| Skill | Invocation Intent / Alias | Purpose | | --- | --- | --- | | developer-tutor | /tutor | Reactive, directional guidance while the developer implements solutions independently. | | socratic-code-review | /review | Surfaces review findings through evidence and investigative questions without supplying code fixes. | | pr-feedback | /feedback | Evaluates a pull request with weighted scores (Correctness 35%, Security 25%, Test coverage 20%, Readability 10%, Performance 10%) and evidence. |

Shared Behavioral Contract

• Language Matching: Responds in the exact language used by the developer.
• Truthfulness & Evidence: Grounded in verified facts, code context, and documentation; never invents defects or runtime behaviors, and marks unverified concerns as Uncertain.
• No Solution Leakage: Strictly withholds copyable code, drop-in replacement snippets, or implementation recipes.
• Professional Detachment: Maintains a neutral, precise tone without generic flattery, cheerleading, or empty praise.
• Safety Override: The non-solution constraint immediately ceases if a concrete risk of security harm, credential/secret exposure, or irreversible data loss/corruption is detected.

Supported Agents and Path Mapping

Kryptonaite copies standard, self-contained skill folders into the documented discovery directory for each supported agent without creating persistent instruction files (AGENTS.md, CLAUDE.md, .cursor/rules):

| Agent (--agent) | Project Scope (--scope project) | User Scope (--scope user) | | --- | --- | --- | | codex | <cwd>/.agents/skills | <home>/.agents/skills | | cursor | <cwd>/.agents/skills | <home>/.agents/skills | | claude | <cwd>/.claude/skills | <home>/.claude/skills |

Installation & Usage

You can use the zero-dependency CLI via npx kryptonaite:

List Available Skills

npx kryptonaite list

Install Skills

Install one or more skills into your project or user environment:

# Install developer-tutor globally for Codex
npx kryptonaite install developer-tutor --agent codex --scope user

# Install code review and PR feedback in the current project for Claude Code
npx kryptonaite install socratic-code-review pr-feedback --agent claude --scope project

# Install all packaged skills into current project for Cursor
npx kryptonaite install --agent cursor --scope project

Use --yes to automatically confirm overwriting existing installations without an interactive prompt.

Uninstall Skills

Kryptonaite will only remove skills verified to be owned by Kryptonaite (marked with <!-- kryptonaite-skill -->):

npx kryptonaite uninstall developer-tutor --agent cursor --scope project

Invoking Installed Skills

Depending on your client's interface:

• Slash Commands: Use native aliases when supported (/tutor, /review, /feedback).
• Skill Name: Mention the skill explicitly by name (e.g., "Use developer-tutor to guide me with pagination").
• Intent Matching: Ask for the skill's capability (e.g., "Review this diff using Socratic code review principles").

Warning: Always inspect third-party skills and their instructions before installing them into your development environment.

Development and Validation

To validate skills and run the complete test suite:

# Validate skill structure and frontmatter
npm run validate

# Run test suite
npm test

# Run full check (validation + test suite)
npm run check

License

MIT - Copyright (c) 2026 Kryptonaite contributors.