synpulse8-opensourcesynpulse8-opensource/pulse8-ai-cortex-knowledge-vault/.cursor/skills/cortex-compiler/SKILL.md

cortex-compiler

Skill15 starsChanged 5 months agoApache-2.0View on GitHub

Cortex raw-to-wiki compiler — ingest, compile, bulk-ingest, manifests, LLM compilation. Use for ingestion pipelines, bulk.py, or compile endpoints.

Reads credentials

In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- cortex-apiSkill
- cortex-authSkill
- cortex-contributingSkill
- cortex-deploySkill
- cortex-feedbackSkill
- cortex-graph-searchSkill
- cortex-mcpSkill
- cortexSkill
- cortex-vaultSkill

The file

Create a free account to mount

Files

SKILL.md

Cortex compiler

Pipeline overview

raw/  →  Compiler (LLM)  →  wiki/*.md  →  graph + QMD index

Key modules

Module	Role
`cortex/compiler/compiler.py`	Single-file compile
`cortex/compiler/bulk.py`	Recursive directory scan, concurrency, manifests
`cortex/compiler/prompts.py`	LLM prompts
`cortex/mcp/tools.py`	`vault_ingest`, `vault_compile`

Manifests (under `.cortex/`)

ingest-manifest.json — SHA-256 of successfully compiled raw files (skip on re-run unless force)
ingest-skip-manifest.json — failures and skips

REST endpoints

Endpoint	Behavior
`POST /api/v1/ingest`	JSON content → `raw/`
`POST /api/v1/ingest/upload`	Multipart upload
`POST /api/v1/compile`	Async compile all pending (202)
`GET /api/v1/compile/status`	Job status
`POST /api/v1/bulk-ingest`	Scan `source_dir` on server filesystem

Bulk ingest body

{
  "source_dir": "/ingest",
  "concurrency": 4,
  "force": false,
  "dry_run": false
}

Logs (cortex.compiler.bulk): Scanning source directory, per-file progress. Also logged from cortex.api.routes on request receipt.

Recursive scan: source_dir is walked recursively; subfolder structure is preserved under the vault raw dir (e.g. source_dir/abcde/a.html → {VAULT_RAW_DIR}/abcde/a.html).

Common failure: source_dir not mounted in container → 400 before bulk runs.

MCP

vault_ingest — write bytes to raw/
vault_compile — trigger compile pass

Config

LLM provider settings in cortex/config.py (model, API keys via env). See .env.example.

Related skills

Vault layout: cortex-vault
Deploy /ingest mount: cortex-deploy
API details: cortex-api

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free