nexus-skills
Agent skills for the NEXUS second brain: recall verified project memory before work, record outcomes after. Works with Claude Code, Codex, Antigravity, Gemini CLI and any MCP client.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/chhunsour--nexus-skills)HTML
<a href="/listings/chhunsour--nexus-skills"><img src="/api/listings/chhunsour--nexus-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**Any agent, via the skills CLI**
npx skills add Chhunsour/nexus-skills # pick skills and agents interactively npx skills add Chhunsour/nexus-skills -g # user-level, every project
**Claude Code plugin marketplace**
/plugin marketplace add Chhunsour/nexus-skills /plugin install nexus@nexus-skills
**Manual (git clone)**
git clone https://github.com/Chhunsour/nexus-skills.git # Then copy or symlink skills/* into your agent's skills folder: # Claude Code ~/.claude/skills/ (project: .claude/skills/) # Codex ~/.codex/skills/ (project: .agents/skills/) # Antigravity ~/.gemini/config/skills/ (project: .agents/skills/) # Gemini CLI ~/.gemini/skills/ ln -s "$PWD"/nexus-skills/skills/* ~/.claude/skills/
Or just ask your agent: *"Install the skills from github.com/Chhunsour/nexus-skills and set up NEXUS."*
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 23 lines
- {
- "name": "nexus-skills",
- "owner": {
- "name": "Chhunsour"
- },
- "metadata": {
- "description": "Agent skills for the NEXUS second brain: recall verified project memory before work, record outcomes after, connect any agent.",
- "version": "1.0.0"
- },
- "plugins": [
- {
- "name": "nexus",
- "description": "Use the NEXUS second brain as long-term memory: setup and diagnostics, recall and record, and capturing project knowledge into the review queue.",
- "source": "./",
- "strict": false,
- "skills": [
- "./skills/nexus-memory",
- "./skills/nexus-setup",
- "./skills/nexus-capture"
- ]
- }
- ]
- }
README.md · README · 92 lines
- # NEXUS Skills
- Agent skills that teach AI agents (Claude Code, Codex, Antigravity, Gemini CLI, Cursor and anything else that reads `SKILL.md`) to use your **NEXUS second brain** as long-term project memory. Agents recall verified decisions and past fixes before they work, and record outcomes and lessons after.
- | Skill | What the agent learns |
- |---|---|
- | [`nexus-memory`](skills/nexus-memory/SKILL.md) | The core loop: pick a surface, **recall** context, decisions and solutions, follow trust rules, **record** outcomes and proposals |
- | [`nexus-setup`](skills/nexus-setup/SKILL.md) | Connect any agent to NEXUS (MCP registration, agent token), plus a read-only **doctor** that diagnoses and prints fixes |
- | [`nexus-capture`](skills/nexus-capture/SKILL.md) | Distill a repo, docs or a session into a small batch of high-quality memory proposals for your review queue |
- ## Install
- **Any agent, via the skills CLI**
- ```bash
- npx skills add Chhunsour/nexus-skills # pick skills and agents interactively
- npx skills add Chhunsour/nexus-skills -g # user-level, every project
- ```
- **Claude Code plugin marketplace**
- ```
- /plugin marketplace add Chhunsour/nexus-skills
- /plugin install nexus@nexus-skills
- ```
- **Manual (git clone)**
- ```bash
- git clone https://github.com/Chhunsour/nexus-skills.git
- # Then copy or symlink skills/* into your agent's skills folder:
- # Claude Code ~/.claude/skills/ (project: .claude/skills/)
- # Codex ~/.codex/skills/ (project: .agents/skills/)
- # Antigravity ~/.gemini/config/skills/ (project: .agents/skills/)
- # Gemini CLI ~/.gemini/skills/
- ln -s "$PWD"/nexus-skills/skills/* ~/.claude/skills/
- ```
- Or just ask your agent: *"Install the skills from github.com/Chhunsour/nexus-skills and set up NEXUS."*
- ## Connect NEXUS (once)
- Ask your agent to *"run the nexus-setup doctor"*, or run it yourself:
- ```bash
- node skills/nexus-setup/scripts/nexus-doctor.mjs
- ```
- The short version for **NEXUS Desktop**:
- 1. Open NEXUS → **AI Agents** → enable Claude Code and/or Codex (allow proposals if you want agents to suggest memories).
- 2. Mark records **verified** and **shared with agents**. Agents see nothing else.
- 3. Register the MCP server:
- ```bash
- claude mcp add --scope user --transport stdio nexus -- '/Applications/NEXUS.app/Contents/MacOS/nexus' --mcp claude
- codex mcp add nexus -- '/Applications/NEXUS.app/Contents/MacOS/nexus' --mcp codex
- ```
- Other MCP clients use `{"command": "/Applications/NEXUS.app/Contents/MacOS/nexus", "args": ["--mcp", "claude"]}`. No MCP at all? The bundled `nexus-mcp.mjs` client works from any shell.
- For the **NEXUS OS server** edition, put `NEXUS_API_URL` and the **agent** token in `~/.config/nexus/agent.env`. See [nexus-setup](skills/nexus-setup/SKILL.md).
- ## Make agents use it automatically
- Paste [`templates/AGENTS.snippet.md`](templates/AGENTS.snippet.md) into your project's `AGENTS.md`, `CLAUDE.md` or `GEMINI.md`.
- ## How it works
- ```mermaid
- flowchart LR
- A[Agent] -->|"skill: nexus-memory"| S{Surface}
- S -->|"A: MCP tools"| D["NEXUS Desktop MCP connector"]
- S -->|"B: nexus-mcp.mjs"| D
- S -->|"C: nexus-api.mjs"| O["NEXUS OS API 127.0.0.1:4100"]
- D -->|"verified + shared only"| R[(Your library)]
- A -->|"propose_memory"| Q[Review queue]
- A -->|"outcome / remember"| U["Unverified memories"]
- Q -->|"you verify"| R
- U -->|"you verify"| R
- ```
- Safety is built in: agents only read what you've verified and shared, every write is unverified or review-queued, the agent token can't verify, edit or delete anything, and the skills tell agents to treat memory content as data, never instructions.
- ## Repository layout
- ```
- skills/<name>/SKILL.md the skills (Agent Skills format)
- skills/*/scripts/ bundled zero-dependency Node clients (Node ≥ 18)
- skills/*/references/ detailed tool/API references, loaded on demand
- shared/scripts/ canonical client sources → tools/sync-scripts.sh copies them into skills
- templates/ AGENTS.md snippet
- .claude-plugin/ Claude Code marketplace manifest
- ```
- Development: edit `shared/scripts/*`, then run `bash tools/sync-scripts.sh && node tools/validate-skills.mjs`. CI checks both.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.