Koko Contextos Agents

koko-contextos-agents

[](https://www.npmjs.com/package/koko-contextos-agents) [](https://opensource.org/licenses/MIT) [](https://nodejs.org/) [](#testing)

This is an open-source set of skills and behavioral rules for AI assistants. The package automatically installs an `.agents` folder into your project, teaching your AI assistant software development best practices (UI Design, Architecture, Security, and more).

Installation

You do not need to clone anything manually. Just open your terminal in the root of your project and run:

npx koko-contextos-agents

The script will automatically detect your project tech stack, create the `.agents` folder, configure skills, and compile them for your AI agent.

Options

npx koko-contextos-agents --help          # Show all options
npx koko-contextos-agents --version       # Show version
npx koko-contextos-agents --profile mvp   # Install with specific profile (mvp, startup, enterprise, frontend, backend)
npx koko-contextos-agents --auto          # Auto-detect tech stack and apply recommended profile
npx koko-contextos-agents --dry-run       # Preview what will be installed
npx koko-contextos-agents --force         # Overwrite an existing .agents/ folder
npx koko-contextos-agents --skip-compile  # Skip auto-compilation step

Why Use This? (Benefits)

• Save Tokens & Context: ContextOS prevents prompt bloat by generating scoped, modular rules (e.g., .cursor/rules/*.mdc with file-pattern matching), compact index templates, and dynamic skill resolution (node .agents/ctx.js resolve) so assistants load only the relevant domain rules.
• **Superior Code Qua