---
title: Skills Index
description: Quick navigation for common tasks and key file paths
tier: 1
keywords: [navigation, tasks, skills, entry-points, quick-start]
related_files: [docs/INDEX.yaml, docs/reference/capabilities.md]
---

# Skills Index

**Purpose:** Quick navigation for common tasks. Load this file first for context efficiency.

---

## Quick Task Navigation

### I want to...

| Task                     | Start Here                                                                   | Then Read                                                                          |
| ------------------------ | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| **Add a feature**        | [CONTRIBUTING.md](../CONTRIBUTING.md)                                        | [development/README.md](./development/README.md)                                   |
| **Fix a bug**            | [TROUBLESHOOTING.md](./TROUBLESHOOTING.md)                                   | [guides/DEBUGGING_OBSERVABILITY.md](./guides/DEBUGGING_OBSERVABILITY.md)           |
| **Add an MCP tool**      | [development/TOOL_DEVELOPMENT.md](./development/TOOL_DEVELOPMENT.md)         | [architecture/MCP_PROTOCOL.md](./architecture/MCP_PROTOCOL.md)                     |
| **Add a CLI command**    | [development/CLI_DELEGATION_GUIDE.md](./development/CLI_DELEGATION_GUIDE.md) | [ENTRYPOINTS.md](./ENTRYPOINTS.md)                                                 |
| **Add a new agent**      | [development/AGENT_DEVELOPMENT.md](./development/AGENT_DEVELOPMENT.md)       | [architecture/AGENT_SYSTEM.md](./architecture/AGENT_SYSTEM.md)                     |
| **Add memory support**   | [development/MEMORY_DEVELOPMENT.md](./development/MEMORY_DEVELOPMENT.md)     | [architecture/MEMORY_SYSTEM.md](./architecture/MEMORY_SYSTEM.md)                   |
| **Create a workflow**    | [guides/WORKFLOW_TEMPLATES.md](./guides/WORKFLOW_TEMPLATES.md)               | Built-in templates in `src/workflows/templates/`                                   |
| **Understand routing**   | [architecture/ROUTING_SYSTEM.md](./architecture/ROUTING_SYSTEM.md)           | [architecture/CONTEXT_LOAD_BALANCING.md](./architecture/CONTEXT_LOAD_BALANCING.md) |
| **Understand consensus** | [architecture/CONSENSUS_PROTOCOLS.md](./architecture/CONSENSUS_PROTOCOLS.md) | [research/topics/consensus/](./research/topics/consensus/)                         |
| **Review security**      | [architecture/SECURITY.md](./architecture/SECURITY.md)                       | [security/API_KEY_BOUNDARIES.md](./security/API_KEY_BOUNDARIES.md)                 |
| **Make a release**       | [CHANGELOG.md](../CHANGELOG.md)                                              | [ALIGNMENT_ROADMAP.md](./ALIGNMENT_ROADMAP.md)                                     |
| **Set up MCP server**    | [guides/MCP_INTEGRATION.md](./guides/MCP_INTEGRATION.md)                     | [QUICK_START.md](../QUICK_START.md)                                                |

---

## Key Files by Category

### Entry Points

- **CLI binary:** `packages/nexus-agents/src/cli.ts`
- **Command dispatch:** `packages/nexus-agents/src/cli-commands.ts`
- **MCP server:** `packages/nexus-agents/src/cli-server.ts`
- **MCP tools:** `packages/nexus-agents/src/mcp/tools/index.ts`

### Core Systems

- **Agent system:** `packages/nexus-agents/src/agents/`
- **Memory system:** `packages/nexus-agents/src/context/`
- **Routing system:** `packages/nexus-agents/src/cli-adapters/`
- **Consensus engine:** `packages/nexus-agents/src/consensus/`
- **Pipeline:** `packages/nexus-agents/src/pipeline/`
- **Orchestration:** `packages/nexus-agents/src/orchestration/`
- **Security:** `packages/nexus-agents/src/security/`
- **Adapters:** `packages/nexus-agents/src/adapters/`
- **Config/Models:** `packages/nexus-agents/src/config/`

### Configuration

- **Default config:** `nexus-agents.yaml`
- **Package.json:** `packages/nexus-agents/package.json`
- **TypeScript config:** `packages/nexus-agents/tsconfig.json`

### Tests

- **Test directory:** `packages/nexus-agents/test/`
- **Coverage reports:** `packages/nexus-agents/coverage/`

---

## Context Loading Strategy

### For Bug Fixes

1. Load: `TROUBLESHOOTING.md`
2. Load: Relevant architecture doc
3. Load: Source file
4. Load: Test file

### For New Features

1. Load: `CONTRIBUTING.md`
2. Load: Relevant development guide
3. Load: Interface spec
4. Load: Example implementation

### For Architecture Decisions

1. Load: `CLAUDE.md` (governance)
2. Load: `architecture/README.md`
3. Load: Relevant ADRs
4. Load: Research if applicable

### For Releases

1. Load: `CHANGELOG.md`
2. Load: `ALIGNMENT_ROADMAP.md`
3. Run: `pnpm build && pnpm test`
4. Run: `nexus-agents fitness-audit`

---

## Capability Quick Reference

**CLI Commands:** 39 total
**MCP Tools:** 24 total
**Workflow Templates:** 11 built-in

For full list: [reference/capabilities.md](./reference/capabilities.md)

---

## Common Commands

```bash
# Development
pnpm install && pnpm build && pnpm test

# Health check
nexus-agents doctor

# Run fitness audit
nexus-agents fitness-audit

# Generate capabilities index (MCP tools, CLIs, etc.)
npx tsx scripts/generate-repo-index.ts

# Regenerate source-derived docs (AgentRole interface, module inventory, ADR counts)
npx tsx scripts/generate-docs-content.ts
```

---

_This index is for LLM context efficiency. Load it first, then load specific docs as needed._
