Skip to content

docs(skills): reorganize skills with audience-based prefixes #1603

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
miyoungc merged 1 commit into from
Apr 8, 2026
Merged

docs(skills): reorganize skills with audience-based prefixes #1603

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .agents/skills/update-docs/SKILL.md → ...nemoclaw-contributor-update-docs/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
name: update-docs
name: nemoclaw-contributor-update-docs
description: Scan recent git commits for changes that affect user-facing behavior, then draft or update the corresponding documentation pages. Use when docs have fallen behind code changes, after a batch of features lands, or when preparing a release. Trigger keywords - update docs, draft docs, docs from commits, sync docs, catch up docs, doc debt, docs behind, docs drift.
---
Comment on lines 1 to 4
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot Apr 8, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

Missing SPDX license header.

This Markdown file must include an SPDX license header before the frontmatter. As per coding guidelines, all .md files require:

<!-- SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. -->
<!-- SPDX-License-Identifier: Apache-2.0 -->
📄 Proposed fix 
+<!-- SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. -->
+<!-- SPDX-License-Identifier: Apache-2.0 -->
+
 ---
 name: nemoclaw-contributor-update-docs
 description: Scan recent git commits for changes that affect user-facing behavior, then draft or update the corresponding documentation pages. Use when docs have fallen behind code changes, after a batch of features lands, or when preparing a release. Trigger keywords - update docs, draft docs, docs from commits, sync docs, catch up docs, doc debt, docs behind, docs drift.
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In @.agents/skills/nemoclaw-contributor-update-docs/SKILL.md around lines 1 - 4,
The file SKILL.md is missing the required SPDX license header before the YAML
frontmatter; add the exact two-line SPDX header comment (the CopyrightText line
and the SPDX-License-Identifier line) immediately above the existing frontmatter
at the top of the file so the header appears before the leading `---` that
begins the `name: nemoclaw-contributor-update-docs` frontmatter.


Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/cut-release-tag/SKILL.md → ...oclaw-maintainer-cut-release-tag/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
name: cut-release-tag
name: nemoclaw-maintainer-cut-release-tag
description: Cut a new semver release tag on main, move the `latest` tag, and push. Use when cutting a release, tagging a version, shipping a build, or preparing a deployment. Trigger keywords - cut tag, release tag, new tag, cut release, tag version, ship it.
user_invocable: true
---
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/find-review-pr/SKILL.md → ...moclaw-maintainer-find-review-pr/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
name: find-review-pr
name: nemoclaw-maintainer-find-review-pr
description: Finds open GitHub PRs with security and priority-high labels, links each to its issue, detects duplicates (multiple PRs fixing the same issue), and presents a table of review candidates. Use when looking for the next PR to review. Trigger keywords - find pr, find review, next pr, pr to review, duplicate pr, security pr.
user_invocable: true
---
Comment on lines 1 to 5
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot Apr 8, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

Missing SPDX license header.

This Markdown file must include an SPDX license header before the frontmatter.

📄 Proposed fix 
+<!-- SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. -->
+<!-- SPDX-License-Identifier: Apache-2.0 -->
+
 ---
 name: nemoclaw-maintainer-find-review-pr
 description: Finds open GitHub PRs with security and priority-high labels, links each to its issue, detects duplicates (multiple PRs fixing the same issue), and presents a table of review candidates. Use when looking for the next PR to review. Trigger keywords - find pr, find review, next pr, pr to review, duplicate pr, security pr.
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In @.agents/skills/nemoclaw-maintainer-find-review-pr/SKILL.md around lines 1 -
5, Add an SPDX license header as the very first line of
.agents/skills/nemoclaw-maintainer-find-review-pr/SKILL.md (i.e., place
"SPDX-License-Identifier: <LICENSE>" before the leading '---' frontmatter);
ensure the header appears above the existing frontmatter that contains name:
nemoclaw-maintainer-find-review-pr so tools recognize the license.

Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/security-code-review/SKILL.md → ...-maintainer-security-code-review/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
name: security-code-review
name: nemoclaw-maintainer-security-code-review
description: Performs a comprehensive security review of code changes in a GitHub PR or issue. Checks out the branch, analyzes changed files against a 9-category security checklist, and produces PASS/WARNING/FAIL verdicts. Use when reviewing pull requests for security vulnerabilities, hardcoded secrets, injection flaws, auth bypasses, or insecure configurations. Trigger keywords - security review, code review, appsec, vulnerability assessment, security audit, review PR security.
user_invocable: true
---
Expand Down
78 changes: 0 additions & 78 deletions .agents/skills/nemoclaw-reference/references/inference-profiles.md
View file
Open in desktop

This file was deleted.

85 changes: 85 additions & 0 deletions .agents/skills/nemoclaw-skills-guide/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
---
name: "nemoclaw-skills-guide"
description: "Start here. Introduces what NemoClaw is, what agent skills are available, and which skill to use for a given task. Use when discovering NemoClaw capabilities, choosing the right skill, or orienting in the project. Trigger keywords - skills, capabilities, what can I do, help, guide, index, overview, start here."
---
Comment on lines +1 to +4
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot Apr 8, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

Missing SPDX license header.

This new Markdown file must include an SPDX license header before the frontmatter.

📄 Proposed fix 
+<!-- SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. -->
+<!-- SPDX-License-Identifier: Apache-2.0 -->
+
 ---
 name: "nemoclaw-skills-guide"
 description: "Start here. Introduces what NemoClaw is, what agent skills are available, and which skill to use for a given task. Use when discovering NemoClaw capabilities, choosing the right skill, or orienting in the project. Trigger keywords - skills, capabilities, what can I do, help, guide, index, overview, start here."
📝 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
---
name: "nemoclaw-skills-guide"
description: "Start here. Introduces what NemoClaw is, what agent skills are available, and which skill to use for a given task. Use when discovering NemoClaw capabilities, choosing the right skill, or orienting in the project. Trigger keywords - skills, capabilities, what can I do, help, guide, index, overview, start here."
---
<!-- SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. -->
<!-- SPDX-License-Identifier: Apache-2.0 -->
---
name: "nemoclaw-skills-guide"
description: "Start here. Introduces what NemoClaw is, what agent skills are available, and which skill to use for a given task. Use when discovering NemoClaw capabilities, choosing the right skill, or orienting in the project. Trigger keywords - skills, capabilities, what can I do, help, guide, index, overview, start here."
---
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In @.agents/skills/nemoclaw-skills-guide/SKILL.md around lines 1 - 4, The file
SKILL.md is missing an SPDX license header before the YAML frontmatter; add a
single-line SPDX header (e.g., "SPDX-License-Identifier: Apache-2.0" or the
project's chosen identifier) immediately at the top of the file before the
leading '---' so the header precedes the frontmatter; ensure the header exact
text matches the project's SPDX identifier and commit the updated SKILL.md.


# NemoClaw Skills Guide

NVIDIA NemoClaw runs OpenClaw always-on assistants inside hardened OpenShell sandboxes with NVIDIA inference (Nemotron).
It provides CLI tooling, guided onboarding, a security blueprint, routed inference, and workspace management.

This guide lists every agent skill shipped with NemoClaw, organized by audience.
Load the specific skill you need after identifying it here.

## Skill Buckets

Skills are grouped into three buckets by audience.
The prefix in each skill name indicates who it is for.

### `nemoclaw-user-*` (9 skills)

For end users operating a NemoClaw sandbox.
Covers installation, inference configuration, network policy management, monitoring, remote deployment, security configuration, workspace management, and reference material.

### `nemoclaw-maintainer-*` (3 skills)

For project maintainers.
Covers cutting releases, finding PRs to review, and performing security code reviews.

### `nemoclaw-contributor-*` (1 skill)

For contributors to the NemoClaw codebase.
Covers drafting documentation updates from recent commits.

## Skill Catalog

### User Skills

| Skill | Summary |
|-------|---------|
| `nemoclaw-user-overview` | What NemoClaw is, ecosystem placement (OpenClaw + OpenShell + NemoClaw), how it works internally, and release notes. |
| `nemoclaw-user-get-started` | Install NemoClaw, launch a sandbox, and run the first agent prompt. |
| `nemoclaw-user-configure-inference` | Choose inference providers during onboarding, switch models without restarting, and set up local inference servers (Ollama, vLLM, TensorRT-LLM, NIM). |
| `nemoclaw-user-manage-policy` | Approve or deny blocked egress requests in the TUI and customize the sandbox network policy (add, remove, or modify allowed endpoints). |
| `nemoclaw-user-monitor-sandbox` | Check sandbox health, read logs, and trace agent behavior to diagnose problems. |
| `nemoclaw-user-deploy-remote` | Deploy NemoClaw to a remote GPU instance, set up the Telegram bridge, and review sandbox container hardening. |
| `nemoclaw-user-configure-security` | Review the risk framework for every configurable security control, understand credential storage, and assess posture trade-offs. |
| `nemoclaw-user-workspace` | Back up and restore OpenClaw workspace files (soul.md, identity.md, memory.md, agents.md) and understand file persistence across sandbox restarts. |
| `nemoclaw-user-reference` | CLI command reference, plugin and blueprint architecture, baseline network policies, and troubleshooting guide. |

### Maintainer Skills

| Skill | Summary |
|-------|---------|
| `nemoclaw-maintainer-cut-release-tag` | Cut an annotated semver tag on main, move the `latest` floating tag, and push both to origin. |
| `nemoclaw-maintainer-find-review-pr` | Find open PRs labeled security + priority-high, link each to its issue, detect duplicates, and present a review summary. |
| `nemoclaw-maintainer-security-code-review` | Perform a 9-category security review of a PR or issue, producing per-category PASS/WARNING/FAIL verdicts. |

### Contributor Skills

| Skill | Summary |
|-------|---------|
| `nemoclaw-contributor-update-docs` | Scan recent git commits for user-facing changes and draft or update the corresponding documentation pages. |

## Quick Decision Guide

Use this table to jump directly to the right skill.

| I want to... | Load this skill |
|---------------|-----------------|
| Install NemoClaw or onboard for the first time | `nemoclaw-user-get-started` |
| Understand what NemoClaw is or how it fits together | `nemoclaw-user-overview` |
| Switch my inference provider or model | `nemoclaw-user-configure-inference` |
| Set up a local model server (Ollama, vLLM, NIM) | `nemoclaw-user-configure-inference` |
| Approve or deny a blocked network request | `nemoclaw-user-manage-policy` |
| Add or remove endpoints from the network policy | `nemoclaw-user-manage-policy` |
| Check sandbox logs, status, or health | `nemoclaw-user-monitor-sandbox` |
| Deploy to a remote GPU or cloud instance | `nemoclaw-user-deploy-remote` |
| Set up Telegram or a chat bridge | `nemoclaw-user-deploy-remote` |
| Review security controls or credential storage | `nemoclaw-user-configure-security` |
| Back up or restore workspace files | `nemoclaw-user-workspace` |
| Look up a CLI command or troubleshoot an error | `nemoclaw-user-reference` |
| Cut a new release tag | `nemoclaw-maintainer-cut-release-tag` |
| Find the next PR to review | `nemoclaw-maintainer-find-review-pr` |
| Security review a pull request | `nemoclaw-maintainer-security-code-review` |
| Update docs after landing code changes | `nemoclaw-contributor-update-docs` |
Loading
Loading