Skip to content

Add npx Skills support for AI coding agents#44

Merged
wey-gu merged 3 commits intomainfrom
claude/add-vercel-npx-skills-AJdj2
Feb 14, 2026
Merged

Add npx Skills support for AI coding agents#44
wey-gu merged 3 commits intomainfrom
claude/add-vercel-npx-skills-AJdj2

Conversation

@wey-gu
Copy link
Copy Markdown
Member

@wey-gu wey-gu commented Jan 28, 2026

Summary

Introduces Nowledge Mem npx Skills, enabling installation of persistent memory capabilities on any supported AI coding agent (Claude Code, Cursor, OpenCode, Codex, and 20+ others) via the npx add-skill CLI.

Changes

  • Updated main README - Added npx Skills installation instructions alongside existing Claude Code plugin option
  • New npx Skills package (nowledge-mem-npx-skills/) with three core skills:
    • Search Memory - Semantic search across personal knowledge base with contextual activation
    • Save Thread - User-initiated session persistence as checkpoints
    • Distill Memory - Automatic detection and capture of breakthrough moments and valuable insights
  • Comprehensive documentation:
    • Package README with installation, prerequisites, and usage examples
    • Individual SKILL.md files for each skill with activation patterns and guidelines
    • CHANGELOG documenting initial 0.1.0 release

Implementation Details

  • Skills are designed for automatic agent detection and installation via add-skill CLI
  • Each skill includes clear activation criteria to avoid over-triggering
  • Prerequisites documented with multiple installation options (uvx recommended, pip fallback)
  • Memory quality guidelines and importance scoring system (0.0-1.0) provided
  • Examples demonstrate real-world usage patterns for each skill
  • Maintains consistency with existing Claude Code plugin documentation

Notes

  • Complements rather than replaces the existing Claude Code plugin (full-featured alternative)
  • All three skills require nmem CLI and local Nowledge Mem server at http://localhost:14242
  • Designed for quality over quantity (1-3 distillations per session typical)

https://claude.ai/code/session_014V4r6Hpbp625jXkkCTDyJm

Summary by CodeRabbit

  • Documentation

    • Added comprehensive docs for Nowledge Mem npx Skills covering Search Memory, Save Thread, and Distill Memory, with usage examples, prerequisites, agent support, and verification steps.
    • Added standalone how‑to guides describing commands, options, and example workflows.
  • Changelog

    • Added an initial CHANGELOG documenting v0.1.0 release highlights.
  • New Features

    • Added a quick npx install snippet for one‑step skill installation.

Note

Low Risk
Documentation-only additions plus new markdown skill definitions; no runtime code paths or security-sensitive logic changes.

Overview
Adds npx Skills distribution for Nowledge Mem, enabling installation into supported AI coding agents via npx skills add alongside the existing Claude Code plugin path.

Introduces a new nowledge-mem-npx-skills/ docs package (README + changelog) plus three skill specifications—search-memory, save-thread, and distill-memory—documenting activation rules, prerequisites (nmem CLI + local server), and usage examples.

Written by Cursor Bugbot for commit 1d47c22. This will update automatically on new commits. Configure here.

- Create nowledge-mem-npx-skills directory with Vercel add-skill format
- Add search-memory skill for semantic knowledge base search
- Add save-thread skill for persisting coding sessions
- Add distill-memory skill for capturing breakthrough moments
- Update main README with npx installation instructions
- Support for Claude Code, Cursor, OpenCode, Codex, and 20+ agents

Install via: npx add-skill nowledge-co/community/nowledge-mem-npx-skills
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Jan 28, 2026

📝 Walkthrough

Walkthrough

Adds documentation and release notes for the Nowledge Mem NPX skills package: a README npx install snippet, a v0.1.0 CHANGELOG, and new SKILL.md docs for search-memory, save-thread, and distill-memory describing prerequisites, usage, flags, and examples.

Changes

Cohort / File(s) Summary
Root README
README.md
Inserts Quick Links npx installation snippet: npx skills add nowledge-co/community/nowledge-mem-npx-skills.
Package metadata & overview
nowledge-mem-npx-skills/CHANGELOG.md, nowledge-mem-npx-skills/README.md
Adds v0.1.0 changelog and a comprehensive package README covering installation (npx/uvx/pip), prerequisites, supported agents, skill overviews, and verification commands.
Skill docs: search-memory
nowledge-mem-npx-skills/skills/search-memory/SKILL.md
New documentation for semantic search: when to use, CLI usage (JSON output), query guidelines, filters, and result interpretation examples.
Skill docs: save-thread
nowledge-mem-npx-skills/skills/save-thread/SKILL.md
New documentation for session persistence: triggers, prerequisites, CLI options (--from, -s/--summary, -m/--mode, -p/--project, --truncate), idempotency, Thread ID format, and sample outputs.
Skill docs: distill-memory
nowledge-mem-npx-skills/skills/distill-memory/SKILL.md
New documentation for distilling high-value memories: triggers, quality/content guidelines, importance scores, flags, examples, and suggested practices.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

Poem

🐰 I hopped through README, changelog aglow,
Wrote three little skills where memories grow,
Search, save, and distill — tidy flags in a row,
A carrot of docs, a soft-paper bow,
Tiny paws, big joy — now off I go!

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding npx Skills support for AI coding agents. It reflects the primary objective of introducing the nowledge-mem-npx-skills package to multiple agent platforms.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Merge Conflict Detection ✅ Passed ✅ No merge conflicts detected when merging into main

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch claude/add-vercel-npx-skills-AJdj2

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

The add-skill package has been renamed to skills.
Updated all documentation to use `npx skills add` instead of `npx add-skill`.
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@nowledge-mem-npx-skills/README.md`:
- Line 5: Replace the old badge link target
"(https://github.com/vercel-labs/add-skill)" in the README badge markdown
"[![npx skills](https://img.shields.io/badge/npx-skills-blue)](...)" with the
renamed skills repo URL "(https://github.com/vercel/skills)" so the badge points
to the correct project for the `npx skills add` CLI.


> Install Nowledge Mem skills on any supported AI coding agent using `npx skills add`.

[![npx skills](https://img.shields.io/badge/npx-skills-blue)](https://github.com/vercel-labs/add-skill)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Update badge link to the renamed skills repo.

The badge still links to the old vercel-labs/add-skill repository, which conflicts with the renamed CLI (npx skills add). Please update the target to the correct skills project URL to avoid confusion.

🔧 Suggested doc fix
-[![npx skills](https://img.shields.io/badge/npx-skills-blue)](https://github.com/vercel-labs/add-skill)
+[![npx skills](https://img.shields.io/badge/npx-skills-blue)](https://github.com/vercel-labs/skills)
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
[![npx skills](https://img.shields.io/badge/npx-skills-blue)](https://github.com/vercel-labs/add-skill)
[![npx skills](https://img.shields.io/badge/npx-skills-blue)](https://github.com/vercel-labs/skills)
🤖 Prompt for AI Agents
In `@nowledge-mem-npx-skills/README.md` at line 5, Replace the old badge link
target "(https://github.com/vercel-labs/add-skill)" in the README badge markdown
"[![npx skills](https://img.shields.io/badge/npx-skills-blue)](...)" with the
renamed skills repo URL "(https://github.com/vercel/skills)" so the badge points
to the correct project for the `npx skills add` CLI.

Comment thread nowledge-mem-npx-skills/skills/distill-memory/SKILL.md Outdated
Some tools require skill names to match their directory names.
Changed:
- nowledge-mem-search → search-memory
- nowledge-mem-save → save-thread
- nowledge-mem-distill → distill-memory
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

This PR is being reviewed by Cursor Bugbot

Details

You are on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.


# Save for specific project path
nmem t save --from claude-code -p /path/to/project
```
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Save-thread hardcodes Claude source

Medium Severity

The save-thread skill always uses nmem t save --from claude-code and Claude-specific paths/IDs, so installations on other agents run the wrong source. In non-Claude environments, save-thread can miss the active session or import unrelated data, which breaks the advertised cross-agent behavior of this package.

Additional Locations (1)

Fix in Cursor Fix in Web

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@nowledge-mem-npx-skills/skills/save-thread/SKILL.md`:
- Around line 87-92: The fenced code block in SKILL.md containing the "Thread
saved" snippet is missing a language tag; update that block to use a language
tag of text (e.g., change ``` to ```text) so markdownlint stops flagging
it—locate the fenced block with the lines "✓ Thread saved", "Summary:
{summary}", "Messages: {count}", "Thread ID: claude-code-{session_id}" and add
the text language marker.

Comment on lines +87 to +92
```
✓ Thread saved
Summary: {summary}
Messages: {count}
Thread ID: claude-code-{session_id}
```
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Add a language tag to the fenced block.
Markdownlint flags this code fence without a language. Use text for the response snippet.

🔧 Suggested change
-```
+```text
 ✓ Thread saved
 Summary: {summary}
 Messages: {count}
 Thread ID: claude-code-{session_id}

</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 Tools
🪛 markdownlint-cli2 (0.20.0)

[warning] 87-87: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
In `@nowledge-mem-npx-skills/skills/save-thread/SKILL.md` around lines 87 - 92,
The fenced code block in SKILL.md containing the "Thread saved" snippet is
missing a language tag; update that block to use a language tag of text (e.g.,
change ``` to ```text) so markdownlint stops flagging it—locate the fenced block
with the lines "✓ Thread saved", "Summary: {summary}", "Messages: {count}",
"Thread ID: claude-code-{session_id}" and add the text language marker.

@wey-gu wey-gu merged commit 787044c into main Feb 14, 2026
2 checks passed
@wey-gu wey-gu deleted the claude/add-vercel-npx-skills-AJdj2 branch February 14, 2026 07:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants