Getting Started

Prerequisites

• Git
• Bash (Linux/macOS) or PowerShell (Windows)
• OpenCode recommended, or any compatible agent (Claude Code, Cursor, Devin Desktop, Kiro)

Installation

Linux / macOS

git clone https://github.com/juandelossantos/another-agent-skills.git
cd another-agent-skills
bash install.sh
init-agents

Windows (PowerShell)

git clone https://github.com/juandelossantos/another-agent-skills.git
cd another-agent-skills
.\install.ps1
init-agents

New Project

Start from scratch in an empty directory:

mkdir my-project && cd my-project
git init
init-agents

After running, you'll see a "Next Steps" summary:

Existing Project

If you already have code and want to add skill-driven enforcement:

cd your-existing-project
init-agents

What happens:

1. Detects existing AGENTS.md, CLAUDE.md, or .cursorrules
2. Backs up existing file
3. Merges our rules (preserving yours)
4. Detects your stack and creates STACK_CONFIG.md if missing
5. Installs hooks (backs up existing hooks)
6. Shows "Next Steps" with improvement suggestions

Stack Detection

init-agents automatically detects your project stack from lockfiles and config files:

Stack	Detects from
Node.js	package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb
Rust	Cargo.lock, Cargo.toml
Python	poetry.lock, Pipfile.lock, pyproject.toml
Go	go.sum, go.mod
Ruby	Gemfile.lock, Gemfile
Dart	pubspec.lock, pubspec.yaml

It creates STACK_CONFIG.md with your actual commands (test, lint, build, dev). All skills read from this file.

Agent Adapters

OpenCode (default)

No extra setup. Skills load automatically via the skill tool.

Claude Code

bash install.sh --agent claude

Creates .claude-plugin/agent-discipline/ with hooks. To also load SOUL.md and AGENTS.md rules, copy the key principles into your CLAUDE.md.

Cursor

bash install.sh --agent cursor

Creates .cursor-plugin/agent-discipline/ with hooks.

Devin Desktop

bash install.sh --agent kiro

Creates .kiro/hooks/agent-discipline.json with pre-flight, commit approval, and edit guard hooks.

Any Git-Based Agent

The git hooks work with any agent that uses git. Copy the hooks to your project:

cp scripts/git-hooks/pre-commit .git/hooks/pre-commit
cp scripts/git-hooks/commit-msg .git/hooks/commit-msg
chmod +x .git/hooks/pre-commit .git/hooks/commit-msg
cp scripts/commit-approval.sh scripts/

Troubleshooting

Issue	Solution
"init-agents: command not found"	Source your shell config: source ~/.zshrc
"STACK_CONFIG.md not found"	Run init-agents in your project
Pre-commit hook not firing	Run bash scripts/init-agents.sh to reinstall
"No commit approval found"	Agent must present DECISION POINT, get "yes commit", then run bash scripts/commit-approval.sh "message"