# Cortex Evolve

> >

- **Type:** Skill
- **Install:** `agentstack add skill-xbluesky-cortexes-cortex-evolve`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [XBlueSky](https://agentstack.voostack.com/s/xbluesky)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [XBlueSky](https://github.com/XBlueSky)
- **Source:** https://github.com/XBlueSky/cortexes/tree/plugin/skills/cortex-evolve
- **Website:** https://cortexes.pages.dev

## Install

```sh
agentstack add skill-xbluesky-cortexes-cortex-evolve
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Cortex Evolve — Save to Vault

Save content to the cortex Obsidian vault.

## Resolve Vault Path

Read `~/.cortex/config.json` to get `vault_path`.
If the file doesn't exist, tell the user to run `/cortex:genesis` first.
All file paths below are relative to the vault root.

## Determine Content Type

Ask the user if unclear. Use these heuristics:

| Signal | Type | Target |
|--------|------|--------|
| Technical knowledge, how-to, concept explanation | Notes | `Notes//.md` |
| Related to a specific repo's design, decision, or progress | Projects | `Projects//.md` |

## Writing to Notes

1. Determine category from content (C++, Linux, Nginx, Web, or create new)
2. Create file at `Notes//.md`
3. Use this template:

```markdown
---
title: 
tags:
  - 
created: 
source: cortex
---

# 

```

4. Use Obsidian wikilinks `[[note-name]]` for vault-internal references
5. Use standard markdown links `[text](url)` for external URLs only

## Writing to Projects

1. Determine repo name (from current session context or ask user)
2. If `Projects//_index.md` doesn't exist, create it:

```markdown
---
title: 
repo: 
tags:
  - project
---

# 

```

3. Create topic file at `Projects//.md`

## Update _index.md

After writing the file:

1. Read `/_index.md`
2. Append a row under the matching `###` sub-section, creating the sub-section
   (with its table header) if it does not exist yet:
   - Notes → `### ` under `## Notes`: `| [[title]] | tags | one-line summary |`
   - Projects → `### ` under `## Projects`: `| [[topic-title]] | tags | summary |`

   Rows are per-page, not per-repo: a new repo means a new `###` sub-section,
   not a single row standing for the whole repo.
3. Bump the `updated` date in frontmatter. There is no `entries:` count to
   maintain — the field was removed by design (see `/cortex:genesis`).

## Append Log Entry

Compose this entry with all placeholders substituted (today's date/time in `YYYY-MM-DD HH:MM` format, the vault-relative path of the saved file, the repo name or `(none)`):

````markdown
## [YYYY-MM-DD HH:MM] evolve | user-initiated
- outcome: new
- target: 
- repo: 
````

Append to `/log.md` using either the Edit tool (preferred — preserves file integrity) or bash:

````bash
printf '\n%s\n' "$ENTRY" >> "/log.md"
````

Where `$ENTRY` is the fully-substituted markdown entry.

Preserve exactly one blank line between entries (achieved by the leading `\n` in the printf above, or by ensuring the Edit tool's appended content starts with a blank line).

The `dedup_top1` field is omitted for evolve entries (evolve does not perform a dedup check in Phase 1; the user explicitly chose to save).

## Commit

In the vault repo:
```
git add  _index.md log.md
git commit -m "cortex:  "
```

If `auto_push` is true in config: `git push`

Confirm to the user what was saved and where.

## Update Vector Store

After committing the new file to the vault:

1. Run: `cortex-vec upsert `

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [XBlueSky](https://github.com/XBlueSky)
- **Source:** [XBlueSky/cortexes](https://github.com/XBlueSky/cortexes)
- **License:** Apache-2.0
- **Homepage:** https://cortexes.pages.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xbluesky-cortexes-cortex-evolve
- Seller: https://agentstack.voostack.com/s/xbluesky
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.