Produktywność osobista · Integracja z narzędziem
cortex-mcp
/cortex-mcp
Pomaga wyszukiwać lub zapisywać notatki w narzędziu Cortex przez MCP, na prośbę użytkownika.
- Autor
- jastorgalj ↗
- Repozytorium
- cortex ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 09.11.2026
Ocena i bezpieczeństwo
96/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność21 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 2
Przestarzałość
Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.
Licencja
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Pomaga wyszukiwać lub zapisywać notatki w narzędziu Cortex przez MCP, na prośbę użytkownika.
Oryginalny opis (EN)
Use when usás Cortex (MCP) para buscar o guardar notas.
Jak działa
- Antes de empezar: ¿está conectado?
- El ciclo, en orden
- La convención vigente
- La nota
- Deduplicado: el servidor avisa, vos decidís
- Concurrencia: dos agentes, una nota
- Borrar deja huella
- Qué merece una nota y qué no
- Antes de cerrar la tarea
Sekcje z nagłówków SKILL.md, w oryginale · 87 linii, 666 słów
Podgląd SKILL.md
---
name: cortex-mcp
description: "Use when usás Cortex (MCP) para buscar o guardar notas."
version: 1.1.0
author: juan-hermes
license: MIT
metadata:
hermes:
tags: [cortex, mcp, memoria, conocimiento, equipo]
category: productivity
---
# Cortex — memoria compartida vía MCP
Cortex es el servidor MCP donde el equipo (personas y agentes) deja lo que no se deduce del código: una
decisión y su porqué, un pitfall con su causa, un flujo con sus trampas. Si tenés las tools
`mcp__cortex__cortex_*`, esta skill te dice **cuándo** usarlas y **qué** escribir; el esquema de cada tool
ya lo trae el MCP.
## Antes de empezar: ¿está conectado?
Si no ves las tools `cortex_*`, no las inventes: avisá cómo conectar el servidor y seguí sin Cortex.
```bash
hermes mcp add cortex --url http://localhost:3091/mcp # y abrir sesión nueva o /reload-mcp
claude mcp add --transport http cortex http://localhost:3091/mcp
```
## El ciclo, en orden
```
Empiezo una tarea en <app> → cortex_search (q + app) y cortex_list con kind=regla
Encontré algo relevante → cortex_read (la nota completa, no el snippet)
Aprendí algo que el equipo debe saber:
¿ya existe? → cortex_update (reason; y base_rev si la leí antes)
¿no existe? → cortex_write (author + app + kind)
Una nota está mal o sobra → cortex_delete (author + reason)
```
Buscar es parte de empezar, no un extra: una tarea resuelta dos veces porque nadie buscó es el costo que
Cortex evita.
## La convención vigente
Las llaves de sistema, los cinco tipos con su esqueleto y las reglas de título, tags y granularidad viven
en Cortex, no en esta skill: `cortex_list(app: "general", kind: "regla")`. Leela antes de escribir la
primera nota de un sistema; si algo no encaja en los cinco tipos, se propone por issue, no se inventa.
## La nota
| Campo | Qué es |
|---|---|
| `title`, `body_md` | Título corto y contenido en Markdown |
| `app` | Llave del sistema: el producto (`console`, `omnisales-pos`, `licitapro`, `general`…) |
| `kind` | `sistema`, `flujo`, `decision`, `pitfall`, `regla` — cinco, sin `otro` |
| `tags` | Con prefijo: `area:`, `repo:`, `stack:`, `env:` (los valores, en la nota de convención); `origen:` lo reserva el importador |
| `author` | Quién escribe (**obligatorio** en toda escritura) |
| `issue` | Ticket de origen, opcional (`CAR-287`, `#134`, una URL) |
`kind` no es decorativo: `regla` es lo que se lista al empezar una tarea en esa app, `pitfall` es lo que
evita repetir un error, `decision` es lo que responde «¿por qué está así?».
## Deduplicado: el servidor avisa, vos decidís
Antes de crear, el servidor compara y responde `similar_exists` si hay algo parecido:
- **Misma idea, otra redacción** → `cortex_update` sobre la existente, con `reason`.
- **Idea distinta que se parece** → crear con `force: true` (y tags que la distingan).
- Nunca dos notas para lo mismo: la segunda se desactualiza y miente.
## Concurrencia: dos agentes, una nota
`cortex_update` acepta `base_rev` (la revisión que leíste). Si otro la cambió en el medio, el servidor
**rechaza e informa la revisión vigente**: volvé a leer, integrá el cambio y reescribí. No reintentes con
la misma `base_rev` ni pises sin leer.
## Borrar deja huella
`cortex_delete` es lógico y exige `author` y `reason`. La nota sale de búsquedas y listados, el historial
guarda quién y por qué. Un dato equivocado se borra: dejarlo «por si acaso» envenena las búsquedas.
## Qué merece una nota y qué no
| Sí | No |
|---|---|
| Una decisión y su porqué | Lo que el código ya dice |
| Un pitfall: síntoma, causa, arreglo | El diff o el historial de git |
| Un flujo con trampas u orden obligatorio | El estado de una tarea de hoy |
| Una regla del equipo que no está escrita | Secretos, claves, tokens, datos personales |
El `body_md` lleva el conocimiento, no el archivo: si hace falta pegar 200 líneas de código, va el
`path:línea` y la conclusión.
## Antes de cerrar la tarea
Preguntate: *¿descubrí algo que el próximo no va a deducir del código?* Si la respuesta es sí y no existe
la nota, escribila ahora —después del cierre ya nadie la escribe.
Wersje
W bazie nie ma innych skilli o nazwie cortex-mcp.
Migawka bazy z 13.11.2026 · wersja paczki 820e3529fce4 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 96cortex-mcp-project
Pomaga w pracy nad repozytorium serwera Cortex MCP, czyli kodem samego serwera. - 100cortex-run
Uruchamia zadanie w Snowflake Cortex Code wyłącznie na jawne polecenie $cortex-run lub /cortex-run, nigdy przez automatyczne kierowanie. - 100cortex-m
Buduje, testuje i rozwija backend Cortex-M (CMSIS-NN) oraz eksportuje modele dla celów Cortex-M. - 100cortex-evolve
Zapisuje wiedzę w vaulcie cortex, obsługując notatki i projekty, także gdy hook sesji zaproponuje zapis treści. - 100research
Bada temat i zapisuje uporządkowane ustalenia w systemie wiedzy Cortex jako notatkę badawczą. - 100cortex-setup-project
Uruchamia Cortex dla nowego projektu lub importuje istniejącą historię sesji, w tym uzupełnia wspomnienia dla bazy kodu z rozmowami Claude Code.