skene-cookbook: Instructions file for Codex

AGENTS.md

AI agent instructions for skene-cookbook - 764 skill library with 36 skill chain recipes.

Quick Context

Repository: Single npm package @skene/skills-directory v0.2.0 Purpose: Pre-built AI skill chains for PLG, sales, customer success, security, and more License: MIT Stack: Node.js 18+ (npm CLI), Python 3.10+ (testing/validation), Pytest (80%+ coverage)

Build & Test Commands

# Install dependencies
npm ci

# Run tests (full suite)
pytest tests/ -v

# Run specific test suites
pytest tests/unit -v -m "not slow"        # Unit tests (fast)
pytest tests/integration -v -m "not slow" # Integration tests
pytest tests/e2e -v                       # End-to-end tests (slow)

# Run linting and formatting
npm run lint                              # ESLint + Prettier
npm run format                            # Auto-fix formatting
black .                                   # Python formatting
flake8 .                                  # Python linting
isort .                                   # Python import sorting

# Verify metrics consistency (skill counts, badges)
npm run verify:metrics

# Run pre-release checks
bash scripts/pre_release_check.sh         # Comprehensive verification

# Pre-commit hooks
pre-commit run --all-files                # Run all hooks (includes detect-secrets)

Test Requirements

• All tests must pass before merging
• Minimum 60% coverage (target: 80%+)
• No failing lint/format checks
• npm run verify:metrics must pass (ensures docs match registry)

Project Structure

skene-cookbook/
├── bin/                          # npm CLI entry point
│   └── skills-directory.js       # Main CLI
├── skills-library/
│   ├── executable/               # 382 executable skills
│   └── reference/                # 382 reference guides
├── docs/
│   ├── SKILL_CHAINS.md           # 36 ready-to-use recipes (PRIMARY USER DOC)
│   ├── PLAYBOOKS.md              # Workflows with data wiring examples
│   └── directory.md              # Full skill catalog
├── registry/
│   ├── blueprints/               # Workflow blueprints (JSON)
│   └── integration_schemas/      # CRM/billing schemas
├── tests/                        # Pytest test suite
│   ├── unit/                     # Fast unit tests
│   ├── integration/              # Integration tests
│   └── e2e/                      # End-to-end user workflows
├── scripts/                      # Python automation scripts
└── eval_harness/                 # Evaluation harness implementation