mirror of
https://github.com/NVIDIA/NemoClaw.git
synced 2026-07-03 03:37:16 +00:00
1aa03d6257
<!-- markdownlint-disable MD041 --> ## Summary This PR retires the generated docs-to-skills pipeline and replaces the expanded generated user skill catalog with one compact `nemoclaw-user-guide` skill. The guide routes AI agents to canonical NemoClaw documentation through the docs MCP server, `llms.txt`, and variant-specific Markdown pages while keeping contributor and maintainer skills intact. ## Changes - Remove `scripts/docs-to-skills.py`, the generated `.agents/skills/nemoclaw-user-*` trees, generated root `skills/nemoclaw-user-*` exports, and generated catalog metadata. - Add `nemoclaw-user-guide` as the single customer-facing user skill under `.agents/skills/`, with matching evals and a hard-copy root `skills/nemoclaw-user-guide` catalog publication copy. - Refresh the root catalog copy through NVSkills signing and document the hard-copy catalog refresh flow. - Update the AI Agent Docs page with the starter prompt button, the NemoClaw docs MCP server URL, Claude Code/Cursor setup guidance, `llms.txt`, and specific `.md` docs routes without the deprecated `llms-full.txt` path. - Update agent guides, contributor docs, PR/issue guidance, catalog signing notes, and CI/static checks to reference Markdown/MCP docs routing instead of generated user-skill refreshes. - Retarget the skill frontmatter test to validate checked-in `SKILL.md` files, guard the single root `skills/` catalog surface, and verify the catalog copy matches the `.agents/skills/nemoclaw-user-guide` source files while allowing NVSkills signing artifacts. ## Type of Change - [ ] Code change (feature, bug fix, or refactor) - [x] Code change with doc updates - [ ] Doc only (prose changes, no code sample modifications) - [ ] Doc only (includes code sample changes) ## Verification <!-- Check each item you ran and confirmed. Leave unchecked items you skipped. Doc-only changes do not require npm test unless you ran it. --> - [ ] PR description includes the DCO sign-off declaration and every commit appears as `Verified` in GitHub - [x] Git hooks passed during commit and push, or `npx prek run --from-ref main --to-ref HEAD` passes - [x] Targeted tests pass for changed behavior - [ ] Full `npm test` passes (broad runtime changes only) - [x] Tests added or updated for new or changed behavior - [x] No secrets, API keys, or credentials committed - [x] Docs updated for user-facing behavior changes - [ ] `npm run docs` builds without warnings (doc changes only) - [x] Doc pages follow the [style guide](https://github.com/NVIDIA/NemoClaw/blob/main/docs/CONTRIBUTING.md) (doc changes only) - [ ] New doc pages include SPDX header and frontmatter (new pages only) --- <!-- DCO sign-off is required in this PR description, and every commit must appear as Verified in GitHub. Run: git config user.name && git config user.email --> Signed-off-by: Miyoung Choi <miyoungc@nvidia.com> <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **New Features** * Introduced `nemoclaw-user-guide` for consolidated AI-agent documentation routing via an MCP docs server, with fallback to Markdown indexing. * **Documentation** * Updated terminology from “Agent Skills” to “AI Agent Docs” across user-facing materials. * Refreshed docs refresh/release workflow and the Verified Skills catalog publishing guidance. * **Deprecations/Removals** * Removed several user-focused skills and their related documentation/evaluation content, consolidating guidance into the user guide. * **Refactor** * Streamlined the workflow to prioritize canonical Markdown docs sources. <!-- end of auto-generated comment: release notes by coderabbit.ai --> --------- Signed-off-by: nvskills-svc-account <svc-nvskills-signing@nvidia.com> Co-authored-by: nvskills-svc-account <svc-nvskills-signing@nvidia.com> |
||
|---|---|---|
| .. | ||
| nemoclaw-user-guide | ||
| README.md | ||
NemoClaw Catalog Skills
This directory is the optional NVSkills CI watched location for customer-facing skill publication.
NemoClaw keeps source skills under .agents/skills/ and copies publishable customer-facing skills here.
Do not put generated documentation copies here.
NemoClaw currently maintains one customer-facing source skill:
.agents/skills/nemoclaw-user-guide/, copied toskills/nemoclaw-user-guide/.
When publishing or refreshing it in the catalog, follow .github/catalog-skills-signing-flow.md.