cortex-setup-project Skill
✓ VerifiziertBoote Cortex für neue Projekte oder importiere bestehende Sitzungsverläufe, um kognitive Profile zu erstellen und Codebase-Memories zu füttern.
- GitHub Stars
- 76
- Dateien
- 1
- Letzter Commit
- 12. Nov. 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der cortex-setup-project Skill?
Boote Cortex für neue Projekte oder importiere bestehende Sitzungsverläufe, um kognitive Profile zu erstellen und Codebase-Memories zu füttern.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den cortex-setup-project skill
Diese Skill ermöglicht es, kognitive Profile zu initialisieren und Codebase-Memories für neue Projekte zu füttern. Entwickler nutzen sie, um das Cortex-System zu bootstrappen, indem sie entweder bei Null anfangen oder bestehende Sitzungsverläufe importieren, um eine Wissensbasis aufzubauen. Der Prozess läuft vollautonom ab und durchläuft Infrastruktur-Verifizierung, Profilerstellung und Codebase-Seeding, ohne dass manuelle Befehle oder Entscheidungen des Nutzers nötig sind.
Ein Agent sollte diese Skill laden, wenn ein Nutzer verlangt, Cortex einzurichten, ein Projekt zu seeden oder Memories nachzufüllen. Sie nutzt Tools wie cortex:memory_stats für Konnektivitätsprüfungen und cortex:rebuild_profiles zur Erstellung von Domain Hubs. Falls der ai-architect-mcp-codebase Server verfügbar ist, kann die Skill eine tiefere Analyse auf Symbol-Level durchführen, um Codebase-Strukturen zu erfassen. Der Prozess schließt mit der Konsolidierung von Memories durch Decay und Kompression ab und liefert eine abschließende Zusammenfassung von Domains, Entities und Wissenslücken.
Was ein agent damit machen kann
- 1Ein neues Projekt-Memory bootstrappenInitialisiere die Cortex-Umgebung für eine frische Codebase, um mit dem Aufbau domänenspezifischer kognitiver Profile zu beginnen.
- 2Vorherige Konversationsverläufe importierenFülle den Memory-Store mit bis zu 500 bestehenden Sitzungsdateien auf, um die Kontinuität des Projektwissens zu wahren.
- 3Tiefe Codebase-Analyse durchführenAktiviere Symbol-Level-Memory und strukturierte Analysen für große Codebases durch die Integration des ai-architect-mcp-codebase Servers.
- 4Memory-Infrastruktur verifizieren und reparierenDiagnostiziere und behebe Konnektivitätsprobleme mit den SQLite- oder PostgreSQL-Memory-Backends automatisch.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den cortex-setup-project Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den cortex-setup-project Skill in Plugin installieren
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Den cortex-setup-project Skill in Claude Code installieren
~/.claude/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.claude/skills/cortex-setup-projectDen cortex-setup-project Skill in Claude Code (project) installieren
.claude/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project .claude/skills/cortex-setup-projectDen cortex-setup-project Skill in Codex installieren
~/.agents/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.agents/skills/cortex-setup-projectDen cortex-setup-project Skill in Gemini CLI installieren
~/.gemini/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.gemini/skills/cortex-setup-projectDen cortex-setup-project Skill in Claude.ai installieren
npx degit cdeust/Cortex/skills/cortex-setup-project cortex-setup-project && zip -r cortex-setup-project.zip cortex-setup-project # claude.ai → Customize → Skills → + → Create skill → Upload a skill → cortex-setup-project.zip
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Hat unsere automatischen Prüfungen bestanden. Das ist kein Sicherheitsaudit: Lesen Sie die Skripte, bevor ein Agent sie ausführt. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarcdeust/cortex/skills/cortex-setup-project is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-setup-proje ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit 2026-11-12github.com/cdeust/cortex/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗Bestanden
- SKILL.md folgt dem Agent-Skills-FormatValid name and description; says when to use it; 67 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗Bestanden
SKILL.md
Auf GitHub ansehenSetup Project — Fully Autonomous Bootstrap
Execute all four phases sequentially without asking the user any questions. If a phase fails, attempt automatic recovery before reporting the error. Never ask the user to run commands manually or choose between options.
Phase 1: Infrastructure Verification
- Call
cortex:memory_stats({})to verify store connectivity. If it succeeds, the store is healthy — this covers both backends (the zero-config SQLite default needs no PostgreSQL, so do NOT runpg_isreadyor any PostgreSQL setup when this passes). Proceed to Phase 2. - Only if
memory_statsfails: callcortex:check_setup({})(backend-aware diagnostics) to identify the failure.- SQLite backend reported: fix per the check output (usually
~/.claude/methodologypermissions or a corruptmemory.db); do NOT install PostgreSQL. - PostgreSQL backend reported: run
pg_isreadyvia bash, thenbash "${CLAUDE_PLUGIN_ROOT}/scripts/setup.sh"automatically. Do not ask for permission. After setup.sh completes, callcortex:memory_stats({})again to verify. - If it still fails, report the error output and stop. Do not continue to later phases.
- SQLite backend reported: fix per the check output (usually
Phase 2: Build Methodology Profiles
- Call
cortex:rebuild_profiles({"force": true})to scan all session history and build cognitive profiles per domain. - This creates the domain hubs that memories, entities, and discussions link to. It must run before seeding.
- Record the domain count for the final summary.
Phase 3: Codebase Seeding
- Call
cortex:seed_project({"directory": "<cwd>"})where<cwd>is the current working directory. - Record the count of discoveries for the final summary.
Phase 3b: Pipeline Codebase Analysis (Optional)
The ai-architect-mcp-codebase MCP server provides structured codebase analysis (symbol graph, processes, communities, cross-file impact). It is optional — Cortex core memory/recall works without it. Enable only if the user asks for "deeper code understanding", "symbol-level memory", or the codebase is large (>5k files) where substring-based hooks underperform.
- Detection: attempt
cortex:ingest_codebase({"project_path": "<cwd>"}). If it succeeds, record the counts (wiki pages, memory entities, KG edges) for the summary and skip to Phase 4. - If
ingest_codebasefails withMcpConnectionError(pipeline not installed/configured):- Check if the sibling checkout exists at
../anthropic/ai-architect-mcp-codebase/Cargo.toml(or equivalent). If so, runbash -c 'cd ../anthropic/ai-architect-mcp-codebase && cargo install --path . 2>&1 | tail -20'(accepts ~1-2 min compile) and re-run the ingest. - If the source checkout is missing or cargo is unavailable, skip Phase 3b silently and proceed to Phase 4. Do NOT block setup on this.
- Check if the sibling checkout exists at
- The pipeline's auto-wire happens on every SessionStart via
pipeline_discovery, so once the binary exists on PATH (or sibling source is built), future sessions pick it up automatically. No manual mcp-connections.json editing needed.
Phase 4: History Import
- Call
cortex:backfill_memories({"dry_run": true, "max_files": 500})to preview available session files. - If files are available, call
cortex:backfill_memories({"max_files": 500, "min_importance": 0.35})to import. - Record the count of imported memories for the final summary.
Phase 5: Consolidation and Verification
- Call
cortex:consolidate({})to run decay, compression, CLS, and causal discovery on all memories. - Call
cortex:memory_stats({})to get the final system state. - Call
cortex:detect_gaps({})to identify knowledge gaps.
Final Summary
After all phases complete, print a single summary block:
Cortex Setup Complete
---------------------
Domains: <count from rebuild_profiles>
Memories stored: <total from memory_stats>
Entities: <count from memory_stats>
Relationships: <count from memory_stats>
Pipeline: <"active — N wiki pages, M memories" | "skipped (not installed)">
Gaps found: <count and brief description from detect_gaps>
Do not print intermediate status updates between phases beyond what the tool calls themselves return. One summary at the end.
Dateien in diesem Skill
1cortex-setup-project Skill-Fragen
Wie installiere ich den cortex-setup-project Skill in Claude Code?
Führe npx degit cdeust/Cortex/skills/cortex-setup-project ~/.claude/skills/cortex-setup-project aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den cortex-setup-project Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Was passiert, wenn die Datenbankverbindung während des Setups fehlschlägt?
Das System versucht eine automatische Wiederherstellung durch backend-spezifische Diagnosen. Bei SQLite werden Berechtigungen oder Korruption geprüft; bei PostgreSQL wird versucht, ein Setup-Skript via bash auszuführen.
Kann ich während des Setups ein tieferes Verständnis meiner Codebase erhalten?
Ja, du kannst eine optionale Pipeline zur Codebase-Analyse für Symbol-Level-Memory und strukturierte Analysen aktivieren, falls dies angefordert wird oder die Codebase groß ist.
Erfordert der Setup-Prozess manuelle Eingriffe durch den Nutzer?
Nein, das Setup ist vollautonom konzipiert und führt alle Phasen nacheinander aus, ohne Fragen zu stellen oder manuelle Befehle zu erfordern.