### Install Context7 Plugin

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Install the Context7 plugin for library documentation and code examples.

```bash
/plugin install context7@claude-plugins-official
```

--------------------------------

### Fetch README for Usage Examples

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/ecosystem-action.md

Extracts usage examples, required permissions, and secrets from an action's README.md file.

```shell
tavily_extract(
  urls=["https://github.com/<owner>/<repo>/blob/main/README.md"],
  query="usage example inputs outputs permissions token secrets"
)
```

--------------------------------

### Install VP-Knowledge Plugin

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Install the VP-Knowledge plugin, a dependency for VP-Claude.

```bash
/plugin install vp-knowledge@vp-plugins
```

--------------------------------

### Package Intel Invocation Examples

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/knowledge-gaps/SKILL.md

Examples of how to invoke the '/package-intel' command for different package managers to get intelligence on undocumented packages.

```bash
/package-intel fastify
/package-intel crate:serde
/package-intel go:github.com/gin-gonic/gin
/package-intel composer:laravel/framework
/package-intel pypi:requests
/package-intel gem:rails
```

--------------------------------

### Install VP-Claude Plugin via Marketplace

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Use this command to add the VP-Claude plugin from the marketplace.

```bash
/plugin marketplace add voxpelli/vp-claude
```

--------------------------------

### Example Dockerfile Usage Pattern

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/note-template-docker.md

Illustrates a common pattern for using a Docker image as a build stage in a Dockerfile.

```dockerfile
FROM docker-<image> AS builder
```

--------------------------------

### Install GitHub CLI Extension

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/note-template-gh.md

Use this command to install the gh-notify extension. Ensure you have the GitHub CLI installed.

```sh
gh extension install meiji163/gh-notify
```

--------------------------------

### Version Drift - Brew Example

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Example format for reporting drifted brew packages, including version information, release date, and semantic versioning class. Used for identifying outdated dependencies.

```markdown
- **brew-<name>** v<bm_version> → v<upstream_version> (released <days_stale>d ago) [<distance-class>]
  — refresh via `/tool-intel brew:<name>`
```

--------------------------------

### Install PyPI Package with pip

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/note-template-pypi.md

Standard command to install a PyPI package using pip. Ensure pip is up-to-date for best results.

```bash
pip install <name>
```

--------------------------------

### Version Drift - All Current Example

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Output message when all documented brew notes are current with upstream and no action is needed.

```markdown
### Version Drift — brew

All N documented brew notes are current with upstream — no action needed.
```

--------------------------------

### Example Dockerfile Non-Root User Instruction

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/note-template-docker.md

Shows the Dockerfile instruction to switch to a non-root user, a security best practice.

```dockerfile
USER <name>
```

--------------------------------

### Packages Frontmatter Example

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/note-template-vscode.md

Illustrates the correct JSON array format for the 'packages' field in the frontmatter, ensuring the full publisher.extension-id is included.

```json
["esbenp.prettier-vscode"]
```

--------------------------------

### Add Basic-Memory-Skills via skills.sh

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Install the basic-memory-skills using the skills.sh CLI, which are core skills this plugin builds upon.

```bash
npx skills add basicmachines-co/basic-memory-skills
```

--------------------------------

### Fetch Install Analytics using MCP

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/ecosystem-brew.md

Call mcp__homebrew__info to retrieve Homebrew install analytics when a local MCP server is available. The tool handles both formulae and casks.

```python
mcp__homebrew__info(formula_or_cask="<name>")
```

--------------------------------

### Add Basic Memory MCP Server

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Install the Basic Memory MCP server, a required backend for the VP-Claude plugin.

```bash
claude mcp add basic-memory -- basic-memory mcp
```

--------------------------------

### Version Drift - Brew Example (Archive)

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Format for reporting brew packages that are candidates for archiving due to being deprecated or disabled upstream. Includes instructions for archiving.

```markdown
- **brew-<name>** v<bm_version> — formula <deprecated|disabled> upstream;
  archive via `move_note(identifier="brew-<name>", new_path="archive/brew-<name>")`
```

--------------------------------

### Cargo.toml Dependencies

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/note-template-crates.md

Example Cargo.toml dependencies for a crate, showing basic usage and usage with features.

```toml
[dependencies]
<name> = "<version>"

# With features:
<name> = { version = "<version>", features = ["<feature>"] }
```

--------------------------------

### Check Brew CLI availability and get installed leaves

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/knowledge-gaps/SKILL.md

Detects if the 'brew' command is available and retrieves the list of installed Homebrew leaves. Skips silently if the command fails.

```bash
command -v brew >/dev/null 2>&1 && brew leaves 2>/dev/null
```

--------------------------------

### Get Repository Contents

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/gh-api-fallback.md

Use this endpoint to retrieve READMEs, manifests, or source files from a specified path within a repository. Omit the file path to get a directory listing.

```bash
gh api repos/<owner>/<repo>/contents/<path>
```

--------------------------------

### Example Accepted Batch of Refreshes

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/knowledge-gaps/references/staleness-detection.md

Demonstrates how multiple refresh commands for different package managers can be accepted in a single turn. This is used when offering to refresh multiple stale notes.

```text
Skill(skill: "package-intel", args: "npm:fastify")
Skill(skill: "package-intel", args: "npm:pino")
Skill(skill: "tool-intel", args: "cask:warp")
```

--------------------------------

### Partial Failure Handling Summary

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-maintainer.md

Example summary reporting the success and failure of a batch of skill invocations, including reasons for failure and notes on skipped entries.

```text
Refreshed 3 of 5 drifted notes — brew:bat, brew:deno, npm:fastify succeeded; crate:serde failed (network), cask:warp failed (schema error). Re-run for serde and warp to retry. Skipped tailscale (stale audit input — already current at 1.96.4 on re-read).
```

--------------------------------

### Composer Package JSON Requirement Example

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/note-template-composer.md

Example of how a Composer package dependency is specified within a `composer.json` file, showing the package name and version constraint.

```json
{
    "require": {
        "<vendor>/<package>": "^<version>"
    }
}

```

--------------------------------

### Duplicate Detection - Package Search

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Example command to search for notes that document the same package across different entries. Used for identifying duplicate documentation.

```javascript
search_notes(metadata_filters={"packages": {"$contains": "<pkg>"}}, page_size=5)
```

--------------------------------

### Version Drift - Brew Example (Unparseable)

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Format for reporting brew packages where the version information could not be extracted from the note content. Suggests running a refresh command to restore metadata.

```markdown
- brew-<name1>, brew-<name2>, ... — version not extractable from note content; run `/tool-intel brew:<name>` to restore the metadata layer
```

--------------------------------

### Add Homebrew MCP Server

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Optional: Add the Homebrew MCP server to surface install analytics. Bundled with Homebrew 4.5+.

```bash
claude mcp add homebrew -- brew mcp-server
```

--------------------------------

### Version Drift - API Unavailable Example

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Format for reporting when the formulae.brew.sh API is unreachable, indicating that staleness checks were skipped for the audit cycle.

```markdown
- formulae.brew.sh unreachable — staleness check skipped this audit cycle
```

--------------------------------

### Version Drift - Brew Example (Age Unknown)

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Format for reporting drifted brew packages when the release date is unavailable. This format highlights the version difference and the need for a refresh.

```markdown
- **brew-<name>** v<bm_version> → v<upstream_version> (release date not available)
  — refresh via `/tool-intel brew:<name>`
```

--------------------------------

### List Tools in Directories

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/knowledge-gaps/SKILL.md

Retrieves a list of tools from specified directories. Use this to get an overview of available tools for each type.

```python
list_directory(dir_name="brew", depth=1)
list_directory(dir_name="casks", depth=1)
list_directory(dir_name="actions", depth=1)
list_directory(dir_name="docker", depth=1)
list_directory(dir_name="vscode", depth=1)
```

--------------------------------

### Version Drift - Brew Example (Not in Registry)

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Format for reporting brew packages that are not found in the central registry, typically due to being tap-installed, renamed, or removed from the core API. Drift check is skipped for these.

```markdown
- brew-<name1>, brew-<name2>, ... — tap-installed formulae (or renamed/removed) not in central API; drift check skipped
```

--------------------------------

### Extract GitHub Repository Details for Go Modules

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/ecosystem-go.md

Use this when the module path starts with 'github.com/'. Extracts readme, description, and license directly from the GitHub repository.

```go
tavily_extract(
  urls=["https://github.com/<owner>/<repo>"],
  query="readme description license"
)
```

--------------------------------

### Hooks Configuration

Source: https://github.com/voxpelli/vp-claude/blob/main/CLAUDE.md

The hooks.json file defines pre-tool use, post-tool use, post-tool use failure, and session start hooks for the plugin.

```json
hooks.json                         # PreToolUse, PostToolUse, PostToolUseFailure, SessionStart
```

--------------------------------

### Cross-Project Consistency - MCP Search (User Paths)

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Example MCP search queries to detect potential project-specific information leaks, specifically looking for user-related paths.

```javascript
search_notes(search_type="text", query="/Users/", page_size=10)
```

```javascript
search_notes(search_type="text", query="/home/", page_size=10)
```

```javascript
search_notes(search_type="text", query="localhost:", page_size=10)
```

--------------------------------

### Prime Knowledge Graph for Project

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Loads project-relevant knowledge before starting work. This read-only agent surfaces context related to your dependencies and project.

```text
Prime the knowledge graph for this project
What does BM know about my deps?
```

--------------------------------

### Check for local symlinked extension installation

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/ecosystem-gh.md

Command to check if an extension is locally installed as a symlink, indicating a development installation.

```shell
find ~/.local/share/gh/extensions/<name>/ -maxdepth 0 -type l
```

--------------------------------

### Generate a project knowledge brief

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Scans project manifests, cross-references dependencies, and provides a concise context brief including gotchas, coverage gaps, and recent activity. Supports expanded output with the --deep flag.

```bash
## Project Knowledge Brief

### Stack detected
- npm: 45 deps (38 documented, 7 undocumented)
- brew: 12 tools (10 documented, 2 undocumented)

### Key gotchas
- **npm-fastify** — [gotcha] reply.send() after reply.redirect() causes hang
- **npm-pino** — [limitation] redaction doesn't work on nested arrays

### Recent activity
- 3 notes updated in last 7 days: npm-fastify, npm-pino, brew-ripgrep

### Gaps worth filling
- Top undocumented dep: `undici` (used in 12 imports)
- Run `/knowledge-gaps` for full coverage analysis
```

--------------------------------

### Get Relation Type Counts

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-maintainer.md

Use `bm project info` to get a full map of relation verbs and their counts, including non-canonical residuals. This is the authoritative source for baseline counts.

```bash
bm project info main --json | jq .statistics.relation_types
```

--------------------------------

### Get Commit History

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/gh-api-fallback.md

Retrieve the commit history for a repository.

```bash
gh api repos/<owner>/<repo>/commits
```

--------------------------------

### Version Drift - VS Code Example (Marketplace Only)

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

Format for reporting VS Code extensions that are only available on the Marketplace and not on Open VSX, indicating a potential security exposure due to a squattable namespace. Recommends a refresh.

```markdown
- vscode-<pub>.<ext> (Marketplace v<x> — not on Open VSX) ⚠ squattable namespace (fork-IDE exposure); refresh via `/tool-intel vscode:<pub>.<ext>`
```

--------------------------------

### Error message for invalid GitHub CLI extension identifier

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/ecosystem-gh.md

Example error message when the input does not conform to the owner/repo format.

```shell
gh: ecosystem requires owner/repo form (got "<input>"); example: gh:meiji163/gh-notify
```

--------------------------------

### List Directory for Package Verification

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-gardener.md

After finding a wiki-link, use this command to check for a corresponding note in the ecosystem's directory. Replace '<ecosystem-dir>' and '<pkg-slug>' with actual values.

```python
list_directory(dir_name="<ecosystem-dir>", file_name_glob="*<pkg-slug>*")
```

--------------------------------

### Add Raindrop MCP Server

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Configure the Raindrop MCP server to search your bookmarked articles. Requires a Raindrop.io Pro account.

```bash
claude mcp add --transport http raindrop https://api.raindrop.io/rest/v2/ai/mcp
```

--------------------------------

### Get primary language of a GitHub repository

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/ecosystem-gh.md

Command to retrieve the primary programming language of a GitHub repository using the GitHub CLI.

```shell
gh repo view <owner>/<repo> --json primaryLanguage
```

--------------------------------

### Get Recent Activity

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-maintainer.md

Retrieve recent activity within a specified timeframe using `recent_activity`. The output format can be specified as JSON.

```python
recent_activity(timeframe="90d", output_format="json")
```

--------------------------------

### Validate Local Schema File

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/schema-evolve/SKILL.md

Checks for the existence of the local schema file. If not found, it lists available schemas to guide the user.

```bash
Glob(pattern="schemas/<note_type>.md")
```

```bash
Glob(pattern="schemas/*.md")
```

--------------------------------

### List Releases

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/gh-api-fallback.md

Count the number of releases for a repository. Use `wc -l` to count the lines, effectively counting releases.

```bash
gh release list --repo <owner>/<repo> --limit 100 | wc -l
```

--------------------------------

### Add Readwise MCP Server

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Set up the Readwise MCP server to search your reading highlights and saved articles. Requires a Readwise account.

```bash
claude mcp add --transport http readwise https://mcp2.readwise.io/mcp
```

--------------------------------

### Verify No Colon-Prefixed Titles

Source: https://github.com/voxpelli/vp-claude/blob/main/TODO-obsidian-migration.md

Check if any titles still start with a colon prefix (e.g., 'npm:'). This command counts the number of such notes.

```bash
bm tool search-notes 'npm:' --json 2>/dev/null | jq '[.results[] | select(.title | startswith("npm:"))] | length'
```

--------------------------------

### Knowledge Primer Agent

Source: https://github.com/voxpelli/vp-claude/blob/main/CLAUDE.md

The knowledge-primer.md file defines an agent for autonomous project context priming.

```markdown
knowledge-primer.md                # Autonomous project context priming
```

--------------------------------

### Pin GitHub Action to Tag

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/ecosystem-action.md

Example of using a GitHub Action pinned to a tag. This method is common but less secure as tags can be moved.

```yaml
uses: actions/checkout@v4
```

--------------------------------

### Extract Go Module Description and License from pkg.go.dev

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/ecosystem-go.md

Preferred method for retrieving module overview, imports, license, and repository links from pkg.go.dev. Requires the module path.

```go
tavily_extract(
  urls=["https://pkg.go.dev/<module-path>"],
  query="module description license readme repository"
)
```

--------------------------------

### Get Commits Since Tag

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/gh-api-fallback.md

Retrieve commits from a specific SHA, used as a fallback when the compare API is unreliable or the tag is potentially renamed.

```bash
gh api commits?sha=<newest-tag>
```

--------------------------------

### DeepWiki Query for Package Details

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/SKILL.md

Use this query to retrieve information about APIs, design patterns, gotchas, and configuration options for a GitHub repository. Skip this source if the repository forge is not GitHub.

```bash
ask_question(repo="owner/repo", question="What are the key APIs, design patterns, gotchas, and configuration options?")
```

--------------------------------

### Validate Shell Scripts

Source: https://github.com/voxpelli/vp-claude/blob/main/CLAUDE.md

Validates shell scripts using shellcheck for linting and shfmt for format verification. Requires shfmt to be installed via Homebrew.

```bash
shellcheck
```

```bash
shfmt -d
```

--------------------------------

### Beads Issue Tracker Quick Reference

Source: https://github.com/voxpelli/vp-claude/blob/main/AGENTS.md

Common commands for the Beads issue tracker. Use 'bd prime' for a full workflow context and command reference.

```bash
bd ready              # Find available work
bd show <id>          # View issue details
bd update <id> --claim  # Claim work
bd close <id>         # Complete work
```

--------------------------------

### Pin GitHub Action to Commit SHA

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/ecosystem-action.md

Example of using a GitHub Action pinned to a specific commit SHA. This is recommended for security as SHAs are immutable.

```yaml
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
```

--------------------------------

### Configure VP-Claude via settings.json

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Manually add VP-Claude configuration to your settings.json file to enable extra known marketplaces and plugins.

```json
{
  "extraKnownMarketplaces": {
    "vp-plugins": {
      "source": { "source": "github", "repo": "voxpelli/claude" }
    }
  },
  "enabledPlugins": {
    "vp-knowledge@vp-plugins": true
  }
}
```

--------------------------------

### Get Recent GitHub Commits

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/SKILL.md

Fetches recent commits for a given tag if no prior release exists for comparison. Used as a fallback for changelog generation.

```bash
gh api "repos/<owner>/<repo>/commits?sha=<newest-tag>"
```

--------------------------------

### Get Git Tags

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/package-intel/references/gh-api-fallback.md

Retrieve Git tags for a repository, useful when the release list is stale or empty. Note that tags are not ordered by semver by default.

```bash
gh api repos/<owner>/<repo>/tags --jq '.[].name'
```

--------------------------------

### Fetch action.yaml Metadata

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/ecosystem-action.md

If action.yml is not found, this attempts to extract metadata from action.yaml.

```shell
tavily_extract(
  urls=["https://github.com/<owner>/<repo>/blob/main/action.yaml"],
  query="inputs outputs runs using permissions secrets"
)
```

--------------------------------

### Add Tavily MCP Server with API Key

Source: https://github.com/voxpelli/vp-claude/blob/main/README.md

Set up the Tavily MCP server for web searches, including security advisories and CVEs. Requires a Tavily API key.

```bash
claude mcp add --transport http tavily https://mcp.tavily.com/mcp \
  --header "Authorization: Bearer tvly-YOUR_KEY_HERE"
```

--------------------------------

### Fetch Upstream Facts for Packages

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/knowledge-gaps/references/staleness-detection.md

Use this command to pipe a list of package names to the appropriate fetch script for the given ecosystem. Ensure the script path and ecosystem name are correct.

```Bash
printf '%s\n' <name1> <name2> … | bash scripts/fetch-<eco>-upstream.sh
```

--------------------------------

### Required Permissions for GitHub Actions

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/tool-intel/references/note-template-action.md

Specifies the necessary permissions required in the calling workflow to execute the GitHub Action. This snippet shows an example of how to define these permissions.

```yaml
permissions:
  <scope>: <read|write>
```

--------------------------------

### Parallel Batch Skill Invocations

Source: https://github.com/voxpelli/vp-claude/blob/main/agents/knowledge-maintainer.md

Demonstrates invoking multiple 'tool-intel' and 'package-intel' skills in parallel for a batch of drifted notes. Use the upstream name for package-intel arguments (e.g., 'packages[0]' for npm).

```bash
Skill(skill: "tool-intel", args: "brew:bat")
Skill(skill: "tool-intel", args: "brew:deno")
Skill(skill: "package-intel", args: "npm:fastify")
Skill(skill: "package-intel", args: "crate:serde")
Skill(skill: "tool-intel", args: "cask:warp")
```

--------------------------------

### Example Drifted >30d Note (npm)

Source: https://github.com/voxpelli/vp-claude/blob/main/skills/knowledge-gaps/references/staleness-detection.md

Illustrates a note that has drifted more than 30 days, requiring a refresh. Includes version details, age, and the command to refresh.

```markdown
### Version Drift — npm — N documented notes checked

#### Drifted >30d (M notes — refresh recommended)

| Note | Documented | Upstream | Released | Distance | Refresh command |
|------|-----------|----------|----------|----------|-----------------|
| npm-fastify | 4.28.1 | 5.8.5 | 410d ago | `[semver-major]` | `/package-intel npm:fastify` |
```