{
  "name": "codebase-context-skill",
  "version": "2.0.0",
  "owner": "Thinqmesh Technologies",
  "repository": "https://github.com/AnitChaudhry/codebase-context-skill",
  "homepage": "https://skills.thinqmesh.com",
  "entry_point": "SKILLS-TREE.md",
  "skills": [
    {
      "id": "init",
      "path": "skills/init/SKILL.md",
      "description": "Deep-research the codebase and generate .ccs/ context files",
      "category": "context",
      "model": "opus",
      "tags": ["index", "scan", "setup", "architecture"],
      "tools": ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task"],
      "input": "codebase root directory",
      "output": ".ccs/ directory with project-map, architecture, file-index, conventions",
      "depends_on": [],
      "token_estimate": 8000,
      "parallel_safe": false
    },
    {
      "id": "status",
      "path": "skills/status/SKILL.md",
      "description": "Show indexed context state, staleness, and token savings",
      "category": "context",
      "model": "haiku",
      "tags": ["check", "health", "staleness"],
      "tools": ["Read", "Glob", "Grep"],
      "input": ".ccs/ directory",
      "output": "status report with staleness and token savings",
      "depends_on": ["init"],
      "token_estimate": 1000,
      "parallel_safe": true
    },
    {
      "id": "query",
      "path": "skills/query/SKILL.md",
      "description": "Preview which files would be selected for a given query",
      "category": "context",
      "model": "haiku",
      "tags": ["search", "preview", "lookup"],
      "tools": ["Read", "Glob", "Grep"],
      "input": "natural language query",
      "output": "ranked list of matching files with relevance",
      "depends_on": ["init"],
      "token_estimate": 1500,
      "parallel_safe": true
    },
    {
      "id": "refresh",
      "path": "skills/refresh/SKILL.md",
      "description": "Rebuild codebase index (full, incremental, or session-based)",
      "category": "context",
      "model": "opus",
      "tags": ["rebuild", "update", "incremental"],
      "tools": ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task"],
      "input": ".ccs/ directory + codebase changes",
      "output": "updated .ccs/ index files",
      "depends_on": ["init"],
      "token_estimate": 5000,
      "parallel_safe": false
    },
    {
      "id": "plan",
      "path": "skills/plan/SKILL.md",
      "description": "Plan a task with full dependency-aware context",
      "category": "workflow",
      "model": "opus",
      "tags": ["plan", "task", "dependency"],
      "tools": ["Read", "Write", "Glob", "Grep", "Task", "EnterPlanMode"],
      "input": "task description",
      "output": "structured plan with dependency graph and file targets",
      "depends_on": ["init"],
      "token_estimate": 4000,
      "parallel_safe": true
    },
    {
      "id": "build",
      "path": "skills/build/SKILL.md",
      "description": "Implement a feature with tracked context and commit-style logging",
      "category": "workflow",
      "model": "sonnet",
      "tags": ["implement", "create", "feature"],
      "tools": ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task"],
      "input": "task/feature description",
      "output": "implemented code + .ccs/task.md entry",
      "depends_on": ["init", "plan"],
      "token_estimate": 6000,
      "parallel_safe": false
    },
    {
      "id": "fix",
      "path": "skills/fix/SKILL.md",
      "description": "Fix bugs with root-cause analysis and dependency tracking",
      "category": "workflow",
      "model": "sonnet",
      "tags": ["debug", "bugfix", "root-cause"],
      "tools": ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task"],
      "input": "bug description or error message",
      "output": "fixed code + root-cause analysis + .ccs/task.md entry",
      "depends_on": ["init"],
      "token_estimate": 5000,
      "parallel_safe": false
    },
    {
      "id": "refactor",
      "path": "skills/refactor/SKILL.md",
      "description": "Scope a refactor — identify all affected files and blast radius",
      "category": "workflow",
      "model": "opus",
      "tags": ["restructure", "blast-radius"],
      "tools": ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task"],
      "input": "refactor scope description",
      "output": "blast radius analysis + refactored code + .ccs/task.md entry",
      "depends_on": ["init"],
      "token_estimate": 5000,
      "parallel_safe": false
    },
    {
      "id": "team",
      "path": "skills/team/SKILL.md",
      "description": "Spawn an agent team for complex multi-part tasks",
      "category": "workflow",
      "model": "opus",
      "tags": ["multi-agent", "parallel", "coordination", "team-lead"],
      "tools": ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task"],
      "input": "complex task description",
      "output": ".ccs/team-board.md + coordinated multi-agent results",
      "depends_on": ["init"],
      "token_estimate": 8000,
      "parallel_safe": false
    },
    {
      "id": "test",
      "path": "skills/test/SKILL.md",
      "description": "Run tests, diagnose failures, suggest or auto-fix",
      "category": "quality",
      "model": "sonnet",
      "tags": ["test", "verify", "auto-fix"],
      "tools": ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task"],
      "input": "test scope (file, suite, or all)",
      "output": "test results + failure analysis + auto-fix suggestions",
      "depends_on": ["init"],
      "token_estimate": 4000,
      "parallel_safe": true
    },
    {
      "id": "audit",
      "path": "skills/audit/SKILL.md",
      "description": "Audit code for security, performance, patterns, accessibility, dead code",
      "category": "quality",
      "model": "opus",
      "tags": ["security", "performance", "a11y", "dead-code"],
      "tools": ["Read", "Glob", "Grep", "Bash", "Task"],
      "input": "audit scope (file, directory, or category)",
      "output": "audit report with findings by severity",
      "depends_on": ["init"],
      "token_estimate": 6000,
      "parallel_safe": true
    },
    {
      "id": "review",
      "path": "skills/review/SKILL.md",
      "description": "Code review with full codebase context",
      "category": "quality",
      "model": "opus",
      "tags": ["code-review", "style", "logic"],
      "tools": ["Read", "Glob", "Grep", "Task"],
      "input": "review scope (file, diff, or PR)",
      "output": "review comments with severity and suggestions",
      "depends_on": ["init"],
      "token_estimate": 5000,
      "parallel_safe": true
    },
    {
      "id": "research",
      "path": "skills/research/SKILL.md",
      "description": "Search docs, resolve errors, check deps, find best practices",
      "category": "quality",
      "model": "opus",
      "tags": ["docs", "errors", "best-practices"],
      "tools": ["Read", "Write", "Glob", "Grep", "WebSearch", "WebFetch", "Task"],
      "input": "research query or error message",
      "output": "research findings cached locally",
      "depends_on": [],
      "token_estimate": 3000,
      "parallel_safe": true
    },
    {
      "id": "branch",
      "path": "skills/branch/SKILL.md",
      "description": "Create or switch branches with auto-generated context reference files",
      "category": "git",
      "model": "sonnet",
      "tags": ["branch", "switch", "context-ref"],
      "tools": ["Read", "Write", "Glob", "Grep", "Bash"],
      "input": "branch name or operation",
      "output": ".ccs/branches/<name>.md context reference",
      "depends_on": ["init"],
      "token_estimate": 2000,
      "parallel_safe": false
    },
    {
      "id": "pr",
      "path": "skills/pr/SKILL.md",
      "description": "Prepare a PR with context — summary, blast radius, review areas",
      "category": "git",
      "model": "opus",
      "tags": ["pull-request", "summary", "blast-radius"],
      "tools": ["Read", "Write", "Glob", "Grep", "Bash", "Task"],
      "input": "PR scope (current branch)",
      "output": ".ccs/pulls/<name>.md + PR creation",
      "depends_on": ["init", "branch"],
      "token_estimate": 4000,
      "parallel_safe": true
    },
    {
      "id": "merge",
      "path": "skills/merge/SKILL.md",
      "description": "Merge branches with dependency checking and conflict context",
      "category": "git",
      "model": "opus",
      "tags": ["merge", "conflict", "resolution"],
      "tools": ["Read", "Write", "Glob", "Grep", "Bash", "Task"],
      "input": "source and target branches",
      "output": "merged code + conflict resolution + .ccs/merge-history.md entry",
      "depends_on": ["init", "branch"],
      "token_estimate": 4000,
      "parallel_safe": false
    },
    {
      "id": "diff",
      "path": "skills/diff/SKILL.md",
      "description": "Smart diff with impact analysis — dependency chains and blast radius",
      "category": "git",
      "model": "opus",
      "tags": ["diff", "impact", "dependency-chain"],
      "tools": ["Read", "Glob", "Grep", "Bash", "Task"],
      "input": "diff scope (file, branch, commit range)",
      "output": "categorized diff with blast radius analysis",
      "depends_on": ["init"],
      "token_estimate": 3000,
      "parallel_safe": true
    },
    {
      "id": "sync",
      "path": "skills/sync/SKILL.md",
      "description": "Pull, push, or rebase with conflict context and resolution guidance",
      "category": "git",
      "model": "sonnet",
      "tags": ["pull", "push", "rebase", "conflict"],
      "tools": ["Read", "Write", "Glob", "Grep", "Bash"],
      "input": "sync operation (pull, push, rebase)",
      "output": "synced repo + conflict resolution if needed",
      "depends_on": ["init"],
      "token_estimate": 3000,
      "parallel_safe": false
    },
    {
      "id": "log",
      "path": "skills/log/SKILL.md",
      "description": "Smart commit history with context and task.md cross-references",
      "category": "git",
      "model": "haiku",
      "tags": ["history", "commits", "cross-ref"],
      "tools": ["Read", "Glob", "Grep", "Bash"],
      "input": "log scope (branch, range, all)",
      "output": "formatted commit history with task cross-references",
      "depends_on": ["init"],
      "token_estimate": 1500,
      "parallel_safe": true
    },
    {
      "id": "stash",
      "path": "skills/stash/SKILL.md",
      "description": "Stash and restore WIP with tracked context",
      "category": "git",
      "model": "haiku",
      "tags": ["stash", "wip", "restore"],
      "tools": ["Read", "Write", "Glob", "Grep", "Bash"],
      "input": "stash operation (save, list, pop, apply)",
      "output": "stashed/restored state + context tracking",
      "depends_on": ["init"],
      "token_estimate": 1500,
      "parallel_safe": true
    },
    {
      "id": "deploy",
      "path": "skills/deploy/SKILL.md",
      "description": "Pre-deployment checklist — tests, build, env vars, deps, breaking changes",
      "category": "ops",
      "model": "opus",
      "tags": ["deploy", "checklist", "env-vars", "breaking-changes"],
      "tools": ["Read", "Glob", "Grep", "Bash", "Task"],
      "input": "deployment target or scope",
      "output": "deployment readiness report with blockers",
      "depends_on": ["init"],
      "token_estimate": 4000,
      "parallel_safe": false
    },
    {
      "id": "track",
      "path": "skills/track/SKILL.md",
      "description": "View/manage the session task log",
      "category": "ops",
      "model": "haiku",
      "tags": ["session", "task-log", "changes"],
      "tools": ["Read", "Glob", "Grep"],
      "input": "optional filter (date, skill, status)",
      "output": "formatted session task log",
      "depends_on": [],
      "token_estimate": 1000,
      "parallel_safe": true
    },
    {
      "id": "connect",
      "path": "skills/connect/SKILL.md",
      "description": "Set up MCP server — create/update .mcp.json and verify connection",
      "category": "setup",
      "model": "sonnet",
      "tags": ["mcp", "server", "endpoint", "config"],
      "tools": ["Read", "Write", "Bash"],
      "input": "MCP endpoint URL or default",
      "output": ".mcp.json configuration + connection verification",
      "depends_on": [],
      "token_estimate": 2000,
      "parallel_safe": false
    }
  ],
  "agents": [
    {
      "id": "context-builder",
      "path": "agents/context-builder.md",
      "description": "Deep codebase analysis, generates .ccs/ index files",
      "model": "opus",
      "tools": ["Read", "Glob", "Grep", "Write"],
      "skills": ["init", "refresh"],
      "parallel_safe": false
    },
    {
      "id": "test-runner",
      "path": "agents/test-runner.md",
      "description": "Run tests, track results, auto-fix failures",
      "model": "sonnet",
      "tools": ["Bash", "Read", "Grep", "Write"],
      "skills": ["test", "fix"],
      "parallel_safe": true
    },
    {
      "id": "code-auditor",
      "path": "agents/code-auditor.md",
      "description": "Security, performance, dead code, accessibility audits",
      "model": "opus",
      "tools": ["Read", "Glob", "Grep"],
      "skills": ["audit", "review"],
      "parallel_safe": true
    },
    {
      "id": "git-tracker",
      "path": "agents/git-tracker.md",
      "description": "Git workflow — branches, PRs, merges, diffs, sync",
      "model": "sonnet",
      "tools": ["Bash", "Read", "Grep", "Write"],
      "skills": ["branch", "pr", "merge", "diff", "sync", "log", "stash"],
      "parallel_safe": false
    },
    {
      "id": "knowledge-guide",
      "path": "agents/knowledge-guide.md",
      "description": "Methodology guidance, note quality, connection suggestions",
      "model": "haiku",
      "tools": ["Read", "Grep"],
      "skills": [],
      "parallel_safe": true
    },
    {
      "id": "team-lead",
      "path": "agents/team-lead.md",
      "description": "Multi-agent team coordination, task decomposition, parallel dispatch",
      "model": "opus",
      "tools": ["Read", "Write", "Glob", "Grep", "Bash", "Task"],
      "skills": ["team"],
      "parallel_safe": false
    }
  ],
  "categories": {
    "context": {
      "skills": ["init", "status", "query", "refresh"],
      "description": "Core indexing and lookup — start here"
    },
    "workflow": {
      "skills": ["plan", "build", "fix", "refactor", "team"],
      "description": "Task execution with dependency tracking"
    },
    "quality": {
      "skills": ["test", "audit", "review", "research"],
      "description": "Verification, security, and knowledge"
    },
    "git": {
      "skills": ["branch", "pr", "merge", "diff", "sync", "log", "stash"],
      "description": "Version control with context awareness"
    },
    "ops": {
      "skills": ["deploy", "track"],
      "description": "Deployment checklists and session tracking"
    },
    "setup": {
      "skills": ["connect"],
      "description": "MCP server configuration"
    }
  },
  "swarm": {
    "entry_point": "SKILLS-TREE.md",
    "machine_index": "manifest.json",
    "agents_index": "AGENTS-INDEX.md",
    "coordination": "filesystem",
    "state_dir": ".ccs/",
    "parallel_read": true,
    "write_lock_files": [".ccs/task.md", ".ccs/merge-history.md", ".ccs/team-board.md"],
    "total_skills": 23,
    "total_agents": 6
  }
}