Agent Skills › mksglu/context-mode › ctx-index

ctx-index

GitHub

将本地文件或目录索引至 FTS5 知识库，以便后续通过 ctx_search 快速检索片段。支持 MCP 工具和 CLI 两种模式，强调安全排除敏感或生成文件。

skills/ctx-index/SKILL.md mksglu/context-mode

Trigger Scenarios

用户请求对项目内容进行索引触发命令 /context-mode:ctx-index

Install

npx skills add mksglu/context-mode --skill ctx-index -g -y

More Options

Use without installing

npx skills use mksglu/context-mode@ctx-index

指定 Agent (Claude Code)

npx skills add mksglu/context-mode --skill ctx-index -a claude-code -g -y

安装 repo 全部 skill

npx skills add mksglu/context-mode --all -g -y

预览 repo 内 skill

npx skills add mksglu/context-mode --list

SKILL.md

Frontmatter

{
    "name": "ctx-index",
    "description": "Index a local file or directory into context-mode's persistent FTS5 knowledge base\nso future ctx_search calls can retrieve focused snippets without rereading raw files.\nTrigger: \/context-mode:ctx-index\n",
    "user-invocable": true
}

Context Mode Index

Index local project content for later search.

Instructions

Prefer the ctx_index MCP tool when it is available.
Ask for a path only if the user did not provide one and the current project root is ambiguous.
Use path, not large inline content, so file bytes do not enter the conversation.
For repository indexing, pass conservative bounds and a clear source label:

ctx_index({
  path: ".",
  source: "project:<name>",
  maxDepth: 5,
  maxFiles: 200
})

If MCP tools are unavailable, fall back to the CLI:

context-mode index . --source project:<name>

Report the indexed source label, file count or section count, and the matching search command:

ctx_search({ source: "project:<name>", queries: ["..."] })

Safety

Do not index dependency directories, build outputs, secrets, or generated artifacts.
Prefer --exclude or exclude for project-specific noisy paths.
For broad repos, ask the user before raising maxFiles above 500.