[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MGKBGSQEGFS6TV2C3XF0M8":3,"skill-same:01M6MGKBGSQEGFS6TV2C3XF0M8":75},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":40,"linkOnly":41,"markdownContent":42,"markdownBody":43,"frontMatter":44,"refName":45,"commitSha":46,"skillDirectory":47,"forksCount":48,"repositoryHtmlUrl":49,"repositoryHomepageUrl":50,"ownerHtmlUrl":51,"ownerBlogUrl":52,"ownerDescription":53,"updatedAt":54,"install":55,"resources":68},"01M6MGKBGSQEGFS6TV2C3XF0M8","codebase-management",null,"Set up, index, and manage SocratiCode codebase indexing. Use when the user wants to index a project, check infrastructure health, start\u002Fstop file watching, configure context artifacts, troubleshoot indexing issues, manage the code graph, or any SocratiCode administrative task. Activates when the user mentions indexing, setting up search, SocratiCode infrastructure, or managing the codebase index.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fgiancarloerra\u002Fsocraticode\u002Fskills\u002Fcodebase-management\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"codebase management","codebase","management","context","when","indexing","project","manage","stop","up","use","troubleshoot","configure","SET","start","graph","search","issues","artifacts","code","infrastructure","2026-11-10 10:12:30",false,"---\nname: codebase-management\ndescription: >-\n  Set up, index, and manage SocratiCode codebase indexing. Use when the user wants to\n  index a project, check infrastructure health, start\u002Fstop file watching, configure\n  context artifacts, troubleshoot indexing issues, manage the code graph, or any\n  SocratiCode administrative task. Activates when the user mentions indexing, setting up\n  search, SocratiCode infrastructure, or managing the codebase index.\n---\n\n# SocratiCode Management\n\nSet up, index, and manage SocratiCode codebase indexing, file watching, code graphs, and context artifacts.\n\n## First-Time Setup\n\n1. **Check infrastructure**: `codebase_health` — verifies Docker, Qdrant, Ollama\u002Fembedding provider, and embedding model\n2. **Start indexing**: `codebase_index` — runs in background, returns immediately\n3. **Poll progress**: `codebase_status` — call every ~60 seconds until 100% complete\n   - This also keeps the MCP connection alive (some hosts disconnect idle connections)\n4. **Done**: Graph auto-builds after indexing. File watcher auto-starts. Ready to search.\n\nOn first use, SocratiCode automatically pulls Docker images, starts containers, and downloads the embedding model (~5 min one-time setup).\n\n## Incremental Updates & File Watching\n\nThe file watcher keeps the index automatically updated. It auto-starts after indexing.\n\n- **`codebase_watch { action: \"start\" }`** — start the watcher (runs catch-up update first)\n- **`codebase_watch { action: \"stop\" }`** — stop the watcher\n- **`codebase_watch { action: \"status\" }`** — list watched projects (including cross-process)\n- **`codebase_update`** — manual incremental update (only changed files, synchronous). Usually not needed if watcher is active.\n\n## Managing Indexes\n\n- **`codebase_stop`** — gracefully pause in-progress indexing. Current batch finishes and checkpoints. All progress preserved. Resume with `codebase_index`.\n- **`codebase_remove`** — delete entire index (destructive). Safely stops watcher, cancels indexing, waits for graph builds.\n- **`codebase_list_projects`** — list all indexed projects with metadata, graph info, and artifact status.\n\n## Managing the Code Graph\n\nThe dependency graph is auto-built after indexing. Manual management is rarely needed.\n\n- **`codebase_graph_build`** — manually rebuild (background, async). Poll with `codebase_graph_status`.\n- **`codebase_graph_remove`** — delete graph (auto-rebuilds on next `codebase_index`)\n- **`codebase_graph_status`** — check build progress or graph readiness\n\n## Context Artifacts Setup\n\nTo index non-code knowledge, create `.socraticodecontextartifacts.json` in the project root:\n\n```json\n{\n  \"artifacts\": [\n    {\n      \"name\": \"database-schema\",\n      \"path\": \".\u002Fdocs\u002Fschema.sql\",\n      \"description\": \"PostgreSQL schema — all tables, indexes, constraints, foreign keys.\"\n    }\n  ]\n}\n```\n\nSupported types: SQL schemas, OpenAPI\u002FProtobuf API specs, Terraform\u002FCloudFormation configs, Kubernetes manifests, architecture docs, environment configs — any text-based file or directory.\n\n- **`codebase_context_index`** — manually index\u002Fre-index all artifacts (usually auto-triggered)\n- **`codebase_context_remove`** — remove all indexed artifacts (blocked during indexing)\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| Docker not available | Install Docker Desktop from https:\u002F\u002Fdocker.com, ensure it's running |\n| Slow indexing on macOS\u002FWindows | Docker can't use GPU. Install native Ollama from https:\u002F\u002Follama.com\u002Fdownload for Metal\u002FCUDA acceleration. Or use cloud embeddings. |\n| Want cloud embeddings instead | Set `EMBEDDING_PROVIDER=openai` + `OPENAI_API_KEY`, or `EMBEDDING_PROVIDER=google` + `GOOGLE_API_KEY` |\n| Search returns no results | Check `codebase_status` — project may not be indexed. Run `codebase_index`. |\n| Stale results | Check if watcher is active (`codebase_status`). Run `codebase_update` or `codebase_watch { action: \"start\" }`. |\n| Indexing was interrupted | Run `codebase_index` again — it resumes from the last checkpoint automatically. |\n| Another process is indexing | `codebase_status` detects cross-process indexing. Wait for it, or use `codebase_stop`. |\n\n## Key Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `QDRANT_MODE` | `managed` | `managed` (Docker) or `external` (remote\u002Fcloud Qdrant) |\n| `QDRANT_URL` | — | Full URL for remote Qdrant (e.g. `https:\u002F\u002Fxyz.cloud.qdrant.io:6333`) |\n| `QDRANT_API_KEY` | — | API key for remote Qdrant |\n| `EMBEDDING_PROVIDER` | `ollama` | `ollama`, `openai`, or `google` |\n| `OPENAI_API_KEY` | — | Required when `EMBEDDING_PROVIDER=openai` |\n| `GOOGLE_API_KEY` | — | Required when `EMBEDDING_PROVIDER=google` |\n| `OLLAMA_MODE` | `auto` | `auto` (detect native, fallback Docker), `docker`, `external` |\n| `EMBEDDING_MODEL` | `nomic-embed-text` | Model name (provider-specific) |\n| `SEARCH_DEFAULT_LIMIT` | `10` | Default result limit for codebase_search (1-50) |\n| `SEARCH_MIN_SCORE` | `0.10` | Default minimum RRF score threshold (0-1) |\n| `MAX_FILE_SIZE_MB` | `5` | Maximum file size for indexing in MB |\n| `EXTRA_EXTENSIONS` | — | Additional file extensions to index (e.g. `.tpl,.blade,.hbs`) |\n\nFor full parameter details on every tool, see [references\u002Ftool-reference.md](references\u002Ftool-reference.md).\n","# SocratiCode Management\n\nSet up, index, and manage SocratiCode codebase indexing, file watching, code graphs, and context artifacts.\n\n## First-Time Setup\n\n1. **Check infrastructure**: `codebase_health` — verifies Docker, Qdrant, Ollama\u002Fembedding provider, and embedding model\n2. **Start indexing**: `codebase_index` — runs in background, returns immediately\n3. **Poll progress**: `codebase_status` — call every ~60 seconds until 100% complete\n   - This also keeps the MCP connection alive (some hosts disconnect idle connections)\n4. **Done**: Graph auto-builds after indexing. File watcher auto-starts. Ready to search.\n\nOn first use, SocratiCode automatically pulls Docker images, starts containers, and downloads the embedding model (~5 min one-time setup).\n\n## Incremental Updates & File Watching\n\nThe file watcher keeps the index automatically updated. It auto-starts after indexing.\n\n- **`codebase_watch { action: \"start\" }`** — start the watcher (runs catch-up update first)\n- **`codebase_watch { action: \"stop\" }`** — stop the watcher\n- **`codebase_watch { action: \"status\" }`** — list watched projects (including cross-process)\n- **`codebase_update`** — manual incremental update (only changed files, synchronous). Usually not needed if watcher is active.\n\n## Managing Indexes\n\n- **`codebase_stop`** — gracefully pause in-progress indexing. Current batch finishes and checkpoints. All progress preserved. Resume with `codebase_index`.\n- **`codebase_remove`** — delete entire index (destructive). Safely stops watcher, cancels indexing, waits for graph builds.\n- **`codebase_list_projects`** — list all indexed projects with metadata, graph info, and artifact status.\n\n## Managing the Code Graph\n\nThe dependency graph is auto-built after indexing. Manual management is rarely needed.\n\n- **`codebase_graph_build`** — manually rebuild (background, async). Poll with `codebase_graph_status`.\n- **`codebase_graph_remove`** — delete graph (auto-rebuilds on next `codebase_index`)\n- **`codebase_graph_status`** — check build progress or graph readiness\n\n## Context Artifacts Setup\n\nTo index non-code knowledge, create `.socraticodecontextartifacts.json` in the project root:\n\n```json\n{\n  \"artifacts\": [\n    {\n      \"name\": \"database-schema\",\n      \"path\": \".\u002Fdocs\u002Fschema.sql\",\n      \"description\": \"PostgreSQL schema — all tables, indexes, constraints, foreign keys.\"\n    }\n  ]\n}\n```\n\nSupported types: SQL schemas, OpenAPI\u002FProtobuf API specs, Terraform\u002FCloudFormation configs, Kubernetes manifests, architecture docs, environment configs — any text-based file or directory.\n\n- **`codebase_context_index`** — manually index\u002Fre-index all artifacts (usually auto-triggered)\n- **`codebase_context_remove`** — remove all indexed artifacts (blocked during indexing)\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| Docker not available | Install Docker Desktop from https:\u002F\u002Fdocker.com, ensure it's running |\n| Slow indexing on macOS\u002FWindows | Docker can't use GPU. Install native Ollama from https:\u002F\u002Follama.com\u002Fdownload for Metal\u002FCUDA acceleration. Or use cloud embeddings. |\n| Want cloud embeddings instead | Set `EMBEDDING_PROVIDER=openai` + `OPENAI_API_KEY`, or `EMBEDDING_PROVIDER=google` + `GOOGLE_API_KEY` |\n| Search returns no results | Check `codebase_status` — project may not be indexed. Run `codebase_index`. |\n| Stale results | Check if watcher is active (`codebase_status`). Run `codebase_update` or `codebase_watch { action: \"start\" }`. |\n| Indexing was interrupted | Run `codebase_index` again — it resumes from the last checkpoint automatically. |\n| Another process is indexing | `codebase_status` detects cross-process indexing. Wait for it, or use `codebase_stop`. |\n\n## Key Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `QDRANT_MODE` | `managed` | `managed` (Docker) or `external` (remote\u002Fcloud Qdrant) |\n| `QDRANT_URL` | — | Full URL for remote Qdrant (e.g. `https:\u002F\u002Fxyz.cloud.qdrant.io:6333`) |\n| `QDRANT_API_KEY` | — | API key for remote Qdrant |\n| `EMBEDDING_PROVIDER` | `ollama` | `ollama`, `openai`, or `google` |\n| `OPENAI_API_KEY` | — | Required when `EMBEDDING_PROVIDER=openai` |\n| `GOOGLE_API_KEY` | — | Required when `EMBEDDING_PROVIDER=google` |\n| `OLLAMA_MODE` | `auto` | `auto` (detect native, fallback Docker), `docker`, `external` |\n| `EMBEDDING_MODEL` | `nomic-embed-text` | Model name (provider-specific) |\n| `SEARCH_DEFAULT_LIMIT` | `10` | Default result limit for codebase_search (1-50) |\n| `SEARCH_MIN_SCORE` | `0.10` | Default minimum RRF score threshold (0-1) |\n| `MAX_FILE_SIZE_MB` | `5` | Maximum file size for indexing in MB |\n| `EXTRA_EXTENSIONS` | — | Additional file extensions to index (e.g. `.tpl,.blade,.hbs`) |\n\nFor full parameter details on every tool, see [references\u002Ftool-reference.md](references\u002Ftool-reference.md).\n",{"name":5,"description":7},"main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002Fgiancarloerra\u002Fsocraticode\u002Fskills\u002Fcodebase-management",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":56,"prompt":66,"zipAvailable":67},[57,60,63],{"tool":58,"command":59},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill codebase-management",{"tool":61,"command":62},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill codebase-management",{"tool":64,"command":65},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill codebase-management","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fgiancarloerra\u002Fsocraticode\u002Fskills\u002Fcodebase-management\u002FSKILL.md",true,[69],{"path":70,"resourceType":71,"resourceTypeDesc":72,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Ftool-reference.md","REFERENCE","参考文档",9507,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fgiancarloerra\u002Fsocraticode\u002Fskills\u002Fcodebase-management\u002Freferences\u002Ftool-reference.md",[76,86,94,102,110,118],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":81,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":85},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":90,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":85},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":98,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":85},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":106,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":85},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":114,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":85},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":122,"sourceHtmlUrl":123,"categories":124,"keywords":125,"publishedAt":85},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]