feat(cli): support cli skills

Signed-off-by: Cory Rylan <crylan@nvidia.com>

Author: coryrylan

projects/cli/README.md

@@ -115,6 +115,8 @@ Skills provide persistent context to AI agents for building UI with Elements.
 | Skill | Description |
 | ----- | ----------- |
 | `elements` | Build UI with NVIDIA Elements (NVE). Provides authoring guidelines, workflow steps, and API best practices for creating, editing, or reviewing HTML templates that use nve-* components. |
+| `authoring` | Authoring workflow guidance for creating, editing, or reviewing HTML templates that use nve-* components. |
+| `migration` | Migration guidance for moving projects from deprecated Elements APIs to current packages and tools. |
 
 ### Tools
 
@@ -130,6 +132,8 @@ Skills provide persistent context to AI agents for building UI with Elements.
 | `packages_changelogs_get` | Retrieve changelog details by package name. |
 | `examples_list` | Get list of available Elements (nve-*) patterns and examples. |
 | `examples_get` | Get the full template of a known example or pattern by id. |
+| `skills_list` | Get a list of available Elements agent skills and context fragments. |
+| `skills_get` | Get a bundled Elements agent skill or context fragment by name. |
 | `playground_validate` | Validates HTML templates specifically for playground examples. |
 | `playground_create` | Create a shareable playground URL from an HTML template. |
 | `project_create` | Create a new starter project. |
@@ -141,4 +145,4 @@ Skills provide persistent context to AI agents for building UI with Elements.
 - [Documentation](https://NVIDIA.github.io/elements/docs/cli/)
 - [Changelog](https://NVIDIA.github.io/elements/docs/changelog/)
 - [GitHub Repo](https://github.com/NVIDIA/elements)
-- [npm](https://www.npmjs.com/package/@nvidia-elements/cli)
+- [npm](https://www.npmjs.com/package/@nvidia-elements/cli)

projects/cli/src/index.test.ts

@@ -37,6 +37,14 @@ describe('index', () => {
     expect(output).toContain('nve examples.get <id> [format]');
   });
 
+  it('should provide skills.list', () => {
+    expect(output).toContain('nve skills.list [format]');
+  });
+
+  it('should provide skills.get', () => {
+    expect(output).toContain('nve skills.get <name> [format]');
+  });
+
   it('should conditionally provide playground.validate when url is available', () => {
     const hasPlayground = output.includes('nve playground.validate');
     expect(typeof hasPlayground).toBe('boolean');

projects/internals/tools/README.md

@@ -10,6 +10,7 @@ This package provides:
 - **Playground creation** and validation utilities
 - **Project management** tools for scaffolding and health checks
 - **Example template** management and search
+- **Agent skill** and context-fragment access
 - **Changelog and version** information services
 - **Design token** access and formatting
 
@@ -21,12 +22,13 @@ The project uses a **decorator-based service architecture** that enables dynamic
 
 ### Service Modules
 
-Seven main service modules organized by functionality:
+Main service modules organized by functionality:
 
 ```
 projects/internals/tools/src/
 ├── api/              # Component API documentation service
 ├── examples/         # Example templates and patterns service
+├── skills/           # Agent skills and context fragments service
 ├── playground/       # Playground creation and validation service
 ├── project/          # Project creation, update, and health checks
 ├── changelogs/       # Release notes and changelog service
@@ -48,6 +50,11 @@ projects/internals/tools/src/
 - `search()` - Search example templates by name or description
 - Pulls from `@internals/metadata`
 
+#### **SkillsService** (`/skills/service.ts`)
+- `list()` - Get available bundled agent skills and context fragments
+- `get()` - Get a skill or context fragment by name
+- Uses bundled markdown so CLI/MCP users can access guidance even when skills are not installed on disk
+
 #### **PlaygroundService** (`/playground/service.ts`)
 - `validate()` - Lint and check HTML templates for playground compliance
 - `create()` - Generate shareable playground URLs with framework support
@@ -125,6 +132,7 @@ The package provides modular entry points for tree-shaking:
   ".": "./dist/index.js",                    // All tools
   "./api": "./dist/api/index.js",           // API service only
   "./examples": "./dist/examples/index.js", // Examples service only
+  "./skills": "./dist/skills/index.js",
   "./playground": "./dist/playground/index.js",
   "./project": "./dist/project/index.js",
   "./changelogs": "./dist/changelogs/index.js",

projects/internals/tools/package.json

@@ -48,6 +48,14 @@
       "types": "./dist/examples/index.d.ts",
       "default": "./dist/examples/index.js"
     },
+    "./skills": {
+      "types": "./dist/skills/index.d.ts",
+      "default": "./dist/skills/index.js"
+    },
+    "./skills/index.js": {
+      "types": "./dist/skills/index.d.ts",
+      "default": "./dist/skills/index.js"
+    },
     "./playground": {
       "types": "./dist/playground/index.d.ts",
       "default": "./dist/playground/index.js"

projects/internals/tools/src/context/search.md

@@ -8,4 +8,9 @@ describe('tools', () => {
   it('should be defined', () => {
     expect(tools).toBeDefined();
   });
+
+  it('should include skills tools', () => {
+    expect(tools.some(tool => tool.metadata.command === 'skills.list')).toBe(true);
+    expect(tools.some(tool => tool.metadata.command === 'skills.get')).toBe(true);
+  });
 });

projects/internals/tools/src/index.test.ts

@@ -7,6 +7,7 @@ import { ApiService } from './api/service.js';
 import { PackagesService } from './packages/service.js';
 import { ProjectService } from './project/service.js';
 import { CliService } from './cli/service.js';
+import { SkillsService } from './skills/service.js';
 import { loadTools } from './internal/tools.js';
 
 declare const __ELEMENTS_PLAYGROUND_BASE_URL__: string;
@@ -28,7 +29,7 @@ export { readNveConfig, saveNveConfig, type NveConfig, type UpdateConfig } from
 export { type Report, type ReportCheck } from './internal/types.js';
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-const services: any[] = [ApiService, CliService, ExamplesService, ProjectService, PackagesService];
+const services: any[] = [ApiService, CliService, ExamplesService, ProjectService, PackagesService, SkillsService];
 
 if (__ELEMENTS_PLAYGROUND_BASE_URL__) {
   services.push(PlaygroundService);
@@ -40,4 +41,4 @@ export { MAX_CONTEXT_CHARS, MAX_CONTEXT_TOKENS, isDebug } from './internal/utils
 
 // temporary exports
 export { getElementImports } from './internal/utils.js';
-export { prompts, skills } from './context/index.js';
+export { prompts, skills, type Prompt, type Skill } from './skills/index.js';

projects/internals/tools/src/index.ts

@@ -27,18 +27,24 @@ vi.mock('./starters.js', () => ({
   claudeProjectSettings: {
     $schema: 'https://json.schemastore.org/claude-code-settings.json',
     permissions: {
-      allow: ['mcp__elements__api_list', 'mcp__elements__api_get']
+      allow: [
+        'mcp__elements__api_list',
+        'mcp__elements__api_get',
+        'mcp__elements__skills_list',
+        'mcp__elements__skills_get'
+      ]
     },
     enabledMcpjsonServers: ['elements']
   }
 }));
 
-vi.mock('../context/index.js', () => ({
+vi.mock('../skills/index.js', () => ({
   skills: [
     {
       name: 'elements',
       title: 'Elements Design System (nve)',
       description: 'Build UI with NVIDIA Elements',
+      kind: 'skill',
       context: '## Elements Context'
     }
   ]
@@ -346,6 +352,8 @@ describe('setup-mcp', () => {
 
       const written = JSON.parse(vi.mocked(writeFileSync).mock.calls[0][1] as string);
       expect(written.permissions.allow).toContain('mcp__elements__api_list');
+      expect(written.permissions.allow).toContain('mcp__elements__skills_list');
+      expect(written.permissions.allow).toContain('mcp__elements__skills_get');
     });
 
     it('should return the settings file path', async () => {

projects/internals/tools/src/project/setup-agent.test.ts

@@ -6,7 +6,7 @@ import { join, resolve } from 'node:path';
 import { getNPMClient } from '../internal/node.js';
 import type { Report } from '../internal/types.js';
 import { claudeProjectSettings } from './starters.js';
-import { skills } from '../context/index.js';
+import { skills } from '../skills/index.js';
 
 type IDE = 'cursor' | 'claude-code' | 'codex' | 'all';
 

projects/internals/tools/src/project/setup-agent.ts

@@ -327,6 +327,8 @@ export const claudeProjectSettings = {
       'mcp__elements__api_tokens_list',
       'mcp__elements__examples_list',
       'mcp__elements__examples_get',
+      'mcp__elements__skills_list',
+      'mcp__elements__skills_get',
       'mcp__elements__project_create',
       'mcp__elements__project_setup',
       'mcp__elements__project_validate',