Skill cortex-setup-project
✓ VerifiedBootstrap Cortex untuk proyek baru atau impor riwayat sesi yang sudah ada untuk membangun profil kognitif dan menanamkan memori codebase.
- Bintang GitHub
- 76
- File
- 1
- Commit terakhir
- 12 Nov 2026
- Lisensi
- MIT
- Tool yang diizinkan
- —
Apa fungsi skill cortex-setup-project?
Bootstrap Cortex untuk proyek baru atau impor riwayat sesi yang sudah ada untuk membangun profil kognitif dan menanamkan memori codebase.
Ringkasan dibuat dari SKILL.md skill ini.
Tentang skill cortex-setup-project
SKILL ini memungkinkan inisialisasi profil kognitif dan penanaman memori codebase untuk proyek baru. Developer menggunakannya untuk melakukan bootstrap pada sistem Cortex, baik dengan memulai dari awal atau mengimpor riwayat sesi yang sudah ada untuk membangun fondasi pengetahuan. Prosesnya berjalan sepenuhnya secara otonom, melewati verifikasi infrastruktur, pembangunan profil, dan seeding codebase tanpa memerlukan eksekusi perintah manual atau keputusan dari pengguna.
Seorang agent harus memuat skill ini saat pengguna meminta untuk melakukan setup Cortex, melakukan seeding pada sebuah proyek, atau mengisi kembali memori (backfill). Skill ini mengandalkan tool seperti cortex:memory_stats untuk pengecekan konektivitas dan cortex:rebuild_profiles untuk membuat domain hub. Jika server ai-architect-mcp-codebase tersedia, skill ini dapat melakukan analisis tingkat simbol yang lebih dalam untuk menyerap struktur codebase. Proses diakhiri dengan konsolidasi memori melalui decay dan kompresi, serta memberikan ringkasan akhir mengenai domain, entitas, dan celah pengetahuan (knowledge gaps).
Apa yang bisa dilakukan agent dengannya
- 1Bootstrap memori proyek baruInisialisasi lingkungan Cortex untuk codebase baru guna mulai membangun profil kognitif spesifik domain.
- 2Impor riwayat percakapan sebelumnyaMengisi kembali memory store dengan hingga 500 file sesi yang sudah ada untuk menjaga kontinuitas pengetahuan proyek.
- 3Melakukan analisis codebase mendalamMengaktifkan memori tingkat simbol dan analisis terstruktur untuk codebase besar dengan mengintegrasikan server ai-architect-mcp-codebase.
- 4Verifikasi dan perbaikan infrastruktur memoriMendiagnosis dan memperbaiki masalah konektivitas pada backend memori SQLite atau PostgreSQL secara otomatis.
Ditulis dari SKILL.md milik skill tersebut. Setiap use case diverifikasi dengan kutipan darinya.
Cara install skill cortex-setup-project
Setiap perintah menyalin folder skill ke direktori skills client. Restart client atau mulai sesi baru untuk memuatnya.Install skill cortex-setup-project di Plugin
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Install skill cortex-setup-project di Claude Code
~/.claude/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.claude/skills/cortex-setup-projectInstall skill cortex-setup-project di Claude Code (project)
.claude/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project .claude/skills/cortex-setup-projectInstall skill cortex-setup-project di Codex
~/.agents/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.agents/skills/cortex-setup-projectInstall skill cortex-setup-project di Gemini CLI
~/.gemini/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.gemini/skills/cortex-setup-projectInstall skill cortex-setup-project di Claude.ai
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
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos cek otomatis kami. Ini bukan audit keamanan: baca skripnya sebelum membiarkan agent menjalankannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaucdeust/cortex/skills/cortex-setup-project is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-setup-proje ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit 2026-11-12github.com/cdeust/cortex/commits ↗Lolos
- Skrip tanpa unduh-lalu-jalankan atau pencurian kredensialNo scripts in the skill folderLolos
- Tidak ada instruksi tersembunyi di SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗Lolos
- Tool yang diizinkan otomatis dibatasiNo pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗Lolos
- SKILL.md mengikuti format Agent SkillsValid name and description; says when to use it; 67 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗Lolos
SKILL.md
Lihat di GitHubSetup 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.
Berkas dalam skill ini
1Pertanyaan seputar skill cortex-setup-project
Bagaimana cara install skill cortex-setup-project di Claude Code?
Jalankan npx degit cdeust/Cortex/skills/cortex-setup-project ~/.claude/skills/cortex-setup-project. Claude Code memuat skill dari ~/.claude/skills (semua proyek) atau .claude/skills (satu proyek) dan menggunakan skill saat deskripsinya cocok dengan tugas.
Client mana saja yang bisa menggunakan skill cortex-setup-project?
Client apa pun yang membaca format Agent Skills: Claude Code, Codex, Gemini CLI, dan claude.ai (unggah sebagai ZIP). Script dalam skill hanya berjalan di client yang mengizinkan eksekusi kode.
Apa yang terjadi jika koneksi database gagal saat setup?
Sistem akan mencoba pemulihan otomatis dengan menjalankan diagnostik yang sadar backend. Untuk SQLite, sistem akan memeriksa izin atau korupsi; untuk PostgreSQL, sistem akan mencoba menjalankan script setup melalui bash.
Bisakah saya mendapatkan pemahaman codebase yang lebih mendalam selama setup?
Ya, Anda dapat mengaktifkan opsi pipeline analisis codebase untuk memori tingkat simbol dan analisis terstruktur jika diminta atau jika codebase berukuran besar.
Apakah proses setup memerlukan intervensi manual dari pengguna?
Tidak, setup dirancang untuk berjalan sepenuhnya secara otonom, mengeksekusi semua fase secara berurutan tanpa mengajukan pertanyaan atau memerlukan eksekusi perintah secara manual.