{"_id":"skills-ref","_rev":"6-ca21b81de8c1b3e6739fa33580e376af","name":"skills-ref","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.0":{"name":"skills-ref","version":"0.1.0","author":{"name":"YanchaoMa","email":"crazyyanchao@gmail.com"},"license":"MIT","_id":"skills-ref@0.1.0","maintainers":[{"name":"yc.ma","email":"yanchaoma@foxmail.com"}],"bin":{"skills-ref":"dist/cli.js"},"dist":{"shasum":"7b6f35c7c4ece0d0e856070661df49c7afb8bb5c","tarball":"https://registry.npmjs.org/skills-ref/-/skills-ref-0.1.0.tgz","fileCount":31,"integrity":"sha512-cYQ66GpzECIqzwc8Kl4x+InS+xjYrHOnGLcS+uIdhI24eqSMvX4qvpBcPDGagTTCVdMOjP+juTqc0Gboz6Uy8w==","signatures":[{"sig":"MEUCIHL226bx1nJCkkhORxQOsw4x7vXVlzw5GrGWu2UosxLYAiEA2MWfgu7dQSl25RkerHrJqZcMptgTFbG2jla5ypEAguo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57451},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b8e024895a58e21a6d3dd85ff7325bf0efc04fc2","scripts":{"lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","test":"vitest","build":"tsc","watch":"tsc --watch","format":"prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"","lint:fix":"eslint \"src/**/*.ts\" \"tests/**/*.ts\" --fix"},"_npmUser":{"name":"yc.ma","email":"yanchaoma@foxmail.com"},"_npmVersion":"10.9.3","description":"Reference library for Agent Skills","directories":{},"_nodeVersion":"22.18.0","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","eslint":"^9.17.0","vitest":"^2.1.8","globals":"^15.15.0","prettier":"^3.4.2","@eslint/js":"^9.17.0","typescript":"^5.7.2","@types/node":"^22.10.2","@types/js-yaml":"^4.0.9","typescript-eslint":"^8.18.1"},"_npmOperationalInternal":{"tmp":"tmp/skills-ref_0.1.0_1766768738132_0.02777666832277581","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"skills-ref","version":"0.1.1","author":{"name":"YanchaoMa","email":"crazyyanchao@gmail.com"},"license":"MIT","_id":"skills-ref@0.1.1","maintainers":[{"name":"yc.ma","email":"yanchaoma@foxmail.com"}],"bin":{"skills-ref":"dist/cli.js"},"dist":{"shasum":"d0858ecef69769d42b55ec7e73c519e29c711454","tarball":"https://registry.npmjs.org/skills-ref/-/skills-ref-0.1.1.tgz","fileCount":31,"integrity":"sha512-Gn3MDL2eRTWOuW9OabaBXZpMnmOqdkabuWOc6FXQE/RwUaWaWSYF0WQymdHdjoegysCUpUHG/ANaz4vD931XKA==","signatures":[{"sig":"MEUCIHJvINBmqEBERiwtKffWpgrn0ne32PPktLFC98B824GmAiEAp8V3jgkJIGrrzJiOJaTvFYlcViIy8SwDQTSLQ7hXGHw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57493},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b8e024895a58e21a6d3dd85ff7325bf0efc04fc2","scripts":{"lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","test":"vitest","build":"tsc","watch":"tsc --watch","format":"prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"","lint:fix":"eslint \"src/**/*.ts\" \"tests/**/*.ts\" --fix"},"_npmUser":{"name":"yc.ma","email":"yanchaoma@foxmail.com"},"_npmVersion":"10.9.3","description":"Reference library for Agent Skills","directories":{},"_nodeVersion":"22.18.0","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","eslint":"^9.17.0","vitest":"^2.1.8","globals":"^15.15.0","prettier":"^3.4.2","@eslint/js":"^9.17.0","typescript":"^5.7.2","@types/node":"^22.10.2","@types/js-yaml":"^4.0.9","typescript-eslint":"^8.18.1"},"_npmOperationalInternal":{"tmp":"tmp/skills-ref_0.1.1_1766768897261_0.652386486849603","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"skills-ref","version":"0.1.2","keywords":["agent","ai","claude","skills","reference","cli","anthropic"],"author":{"name":"YanchaoMa","email":"crazyyanchao@gmail.com"},"license":"MIT","_id":"skills-ref@0.1.2","maintainers":[{"name":"yc.ma","email":"yanchaoma@foxmail.com"}],"bin":{"skills-ref":"dist/skills-ref/cli.js"},"dist":{"shasum":"cab6f15d1b9fd6f322b7201f1225d0d8ced05274","tarball":"https://registry.npmjs.org/skills-ref/-/skills-ref-0.1.2.tgz","fileCount":31,"integrity":"sha512-8ONrIvUYMCjCS8AISEmYVucdDfzCXDv0VbaaFM6bBnLMyfXNAFtq0gaks3tkIqnT425RI/wr9HG5pB+0sFPSLA==","signatures":[{"sig":"MEUCIHVkslPuR/3GDjGAed7Vffd0BNl7vdq4Y9HWfpRnjOCDAiEAg6AMggEXt4JkcGe1UM5znfzx2ylCr4JocC/lM4EVXwo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57620},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b8e024895a58e21a6d3dd85ff7325bf0efc04fc2","scripts":{"lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","test":"vitest","build":"tsc","watch":"tsc --watch","format":"prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"","lint:fix":"eslint \"src/**/*.ts\" \"tests/**/*.ts\" --fix"},"_npmUser":{"name":"yc.ma","email":"yanchaoma@foxmail.com"},"_npmVersion":"10.9.3","description":"Reference library for Agent Skills","directories":{},"_nodeVersion":"22.18.0","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","eslint":"^9.17.0","vitest":"^2.1.8","globals":"^15.15.0","prettier":"^3.4.2","@eslint/js":"^9.17.0","typescript":"^5.7.2","@types/node":"^22.10.2","@types/js-yaml":"^4.0.9","typescript-eslint":"^8.18.1"},"_npmOperationalInternal":{"tmp":"tmp/skills-ref_0.1.2_1766769287202_0.20012807589539805","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"skills-ref","version":"0.1.3","keywords":["agent","ai","claude","skills","reference","cli","anthropic"],"author":{"name":"YanchaoMa","email":"crazyyanchao@gmail.com"},"license":"MIT","_id":"skills-ref@0.1.3","maintainers":[{"name":"yc.ma","email":"yanchaoma@foxmail.com"}],"bin":{"skills-ref":"dist/cli.js"},"dist":{"shasum":"ab755e1e2ea90cf7b8395f9c1617d1784a06738c","tarball":"https://registry.npmjs.org/skills-ref/-/skills-ref-0.1.3.tgz","fileCount":31,"integrity":"sha512-63/QPk3waN/+v3RDyouNoPsnQ5072Rle7HTfRT55AvUXp17K9aUj06zo9+UHFLpRzSr75EAUmJPJKb7toJjSNA==","signatures":[{"sig":"MEUCIGKU7LkHNRvKWeG1rYyrRFBsdqn3W0QgWVl8QuziFQBEAiEA6QDMzYLeJff/phYsGq/F1CCwYBMbaWXs+LHiux0rgPc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59172},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"74e69a288d8b8f6ffd4c96137c3d475b85f399d9","scripts":{"lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","test":"vitest","build":"tsc","watch":"tsc --watch","format":"prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"","lint:fix":"eslint \"src/**/*.ts\" \"tests/**/*.ts\" --fix"},"_npmUser":{"name":"yc.ma","email":"yanchaoma@foxmail.com"},"_npmVersion":"10.9.3","description":"Reference library for Agent Skills","directories":{},"_nodeVersion":"22.18.0","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","eslint":"^9.17.0","vitest":"^2.1.8","globals":"^15.15.0","prettier":"^3.4.2","@eslint/js":"^9.17.0","typescript":"^5.7.2","@types/node":"^22.10.2","@types/js-yaml":"^4.0.9","typescript-eslint":"^8.18.1"},"_npmOperationalInternal":{"tmp":"tmp/skills-ref_0.1.3_1766836338256_0.9820083076525852","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"skills-ref","version":"0.1.4","keywords":["agent","ai","claude","skills","reference","cli","anthropic"],"author":{"name":"YanchaoMa","email":"crazyyanchao@gmail.com"},"license":"MIT","_id":"skills-ref@0.1.4","maintainers":[{"name":"yc.ma","email":"yanchaoma@foxmail.com"}],"bin":{"skills-ref":"dist/cli.js"},"dist":{"shasum":"d8e5d95925be137c2522cba8fc1913b87b07cc31","tarball":"https://registry.npmjs.org/skills-ref/-/skills-ref-0.1.4.tgz","fileCount":31,"integrity":"sha512-/Wah164ZN14sTgQSSmd8DD49jeRPsm5aYg2Diir9MQv4Uk72s04ebxwAUsoa41x/vbLxKAHlOV4m+o1ynLNojg==","signatures":[{"sig":"MEUCIQD+KXwHfHi0iC3qL+a7sV/AEN9LJEUfsLsInRBIbkwFggIgOP8AD3zxyRH63j4/whbdoJn+C27ysb1Y3/b0yZM87UI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59170},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"74e69a288d8b8f6ffd4c96137c3d475b85f399d9","scripts":{"lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","test":"vitest","build":"tsc","watch":"tsc --watch","format":"prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"","lint:fix":"eslint \"src/**/*.ts\" \"tests/**/*.ts\" --fix"},"_npmUser":{"name":"yc.ma","email":"yanchaoma@foxmail.com"},"_npmVersion":"10.9.3","description":"Reference library for Agent Skills","directories":{},"_nodeVersion":"22.18.0","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","eslint":"^9.17.0","vitest":"^2.1.8","globals":"^15.15.0","prettier":"^3.4.2","@eslint/js":"^9.17.0","typescript":"^5.7.2","@types/node":"^22.10.2","@types/js-yaml":"^4.0.9","typescript-eslint":"^8.18.1"},"_npmOperationalInternal":{"tmp":"tmp/skills-ref_0.1.4_1766836781659_0.9692547640779245","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"skills-ref","version":"0.1.5","description":"Reference library for Agent Skills","keywords":["agent","ai","claude","skills","reference","cli","anthropic"],"license":"MIT","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"bin":{"skills-ref":"dist/cli.js"},"scripts":{"build":"tsc","watch":"tsc --watch","format":"prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"","lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","lint:fix":"eslint \"src/**/*.ts\" \"tests/**/*.ts\" --fix","test":"vitest"},"devDependencies":{"@eslint/js":"^9.17.0","@types/js-yaml":"^4.0.9","@types/node":"^22.10.2","eslint":"^9.17.0","globals":"^15.15.0","prettier":"^3.4.2","tsx":"^4.19.2","typescript":"^5.7.2","typescript-eslint":"^8.18.1","vitest":"^2.1.8"},"dependencies":{"commander":"^12.1.0","js-yaml":"^4.1.0"},"engines":{"node":">=18.0.0"},"author":{"name":"YanchaoMa","email":"crazyyanchao@gmail.com"},"_id":"skills-ref@0.1.5","gitHead":"23b0842a4c470fab5261255e2f0478fde2ece35f","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-C2vyZbUQqt3PXA9vcdUmJ0lwbH9jK19C9fwQjl/ICPy2e5bzV3CaropViakJCv+HLt/9zsgjZ/NLJ5xEri0jSA==","shasum":"08bd74d5bc30038eaba26acbe4b58da8b051aa5e","tarball":"https://registry.npmjs.org/skills-ref/-/skills-ref-0.1.5.tgz","fileCount":31,"unpackedSize":59290,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIC/k+WHuG9+RHaFxBIoGxv+2asUxD+XLJxdtWf3MqcaGAiBwF96l7NzfUhi1EfNlqSFMcjnfD+VzJOjRuEpd4eVBhQ=="}]},"_npmUser":{"name":"yc.ma","email":"yanchaoma@foxmail.com"},"directories":{},"maintainers":[{"name":"yc.ma","email":"yanchaoma@foxmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skills-ref_0.1.5_1766851806137_0.6031992508130339"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-26T17:05:38.014Z","modified":"2025-12-27T16:10:06.507Z","0.1.0":"2025-12-26T17:05:38.280Z","0.1.1":"2025-12-26T17:08:17.473Z","0.1.2":"2025-12-26T17:14:47.355Z","0.1.3":"2025-12-27T11:52:18.403Z","0.1.4":"2025-12-27T11:59:41.895Z","0.1.5":"2025-12-27T16:10:06.299Z"},"author":{"name":"YanchaoMa","email":"crazyyanchao@gmail.com"},"license":"MIT","keywords":["agent","ai","claude","skills","reference","cli","anthropic"],"description":"Reference library for Agent Skills","maintainers":[{"name":"yc.ma","email":"yanchaoma@foxmail.com"}],"readme":"# skills-ref\n\n[![English](https://img.shields.io/badge/English-Click-yellow)](README.md)\n[![中文文档](https://img.shields.io/badge/中文文档-点击查看-orange)](README-zh.md)\n\nReference library for Agent Skills.\n\n> **Note:** This library is intended for demonstration purposes only. It is not meant to be used in production.\n\n## Installation\n\n```bash\npnpm install\n```\n\nAfter installation, `skills-ref` CLI will be available.\n\n## Usage\n\n### CLI\n\n```bash\n# Validate a skill\nskills-ref validate path/to/skill\n\n# Read skill properties (outputs JSON)\nskills-ref read-properties path/to/skill\n\n# Generate <available_skills> XML for agent prompts\nskills-ref to-prompt path/to/skill-a path/to/skill-b\n```\n\n```bash\nPS C:\\Users\\admin> npm install -g skills-ref\n\nadded 4 packages in 2s\nPS C:\\Users\\admin> skills-ref --help\nUsage: cli [options] [command]\n\nReference library for Agent Skills\n\nOptions:\n  -V, --version                 output the version number\n  -h, --help                    display help for command\n\nCommands:\n  validate <skill_path>\n  read-properties <skill_path>\n  to-prompt <skill_paths...>\n  help [command]                display help for command\nPS C:\\Users\\admin> skills-ref validate F:\\ai-project\\skills\\skills\\algorithmic-art\nValid skill: F:\\ai-project\\skills\\skills\\algorithmic-art\nPS C:\\Users\\admin>\nPS C:\\Users\\admin> skills-ref read-properties F:\\ai-project\\skills\\skills\\algorithmic-art\n{\n  \"name\": \"algorithmic-art\",\n  \"description\": \"Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.\",\n  \"license\": \"Complete terms in LICENSE.txt\"\n}\nPS C:\\Users\\admin> skills-ref to-prompt F:\\ai-project\\skills\\skills\\algorithmic-art\n<available_skills>\n<skill>\n<name>\nalgorithmic-art\n</name>\n<description>\nCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists&#39; work to avoid copyright violations.\n</description>\n<location>\nF:\\ai-project\\skills\\skills\\algorithmic-art\\SKILL.md\n</location>\n</skill>\n</available_skills>\nPS C:\\Users\\admin>\n```\n\n### TypeScript API\n\n```typescript\nimport { validate, readProperties, toPrompt } from \"skills-ref\";\n\n// Validate a skill directory\nconst problems = await validate(\"my-skill\");\nif (problems.length > 0) {\n  console.log(\"Validation errors:\", problems);\n}\n\n// Read skill properties\nconst props = await readProperties(\"my-skill\");\nconsole.log(`Skill: ${props.name} - ${props.description}`);\n\n// Generate prompt for available skills\nconst prompt = await toPrompt([\"skill-a\", \"skill-b\"]);\nconsole.log(prompt);\n```\n\n## Development\n\n```bash\n# Build the project\npnpm build\n\n# Run tests\npnpm test\n\n# Format code\npnpm format\n\n# Lint code\npnpm lint\npnpm lint:fix\n```\n\n## Agent Prompt Integration\n\nUse `to-prompt` to generate the suggested `<available_skills>` XML block for your agent's system prompt. This format is recommended for Anthropic's models, but Skill Clients may choose to format it differently based on the model being used.\n\n```xml\n<available_skills>\n<skill>\n<name>\nmy-skill\n</name>\n<description>\nWhat this skill does and when to use it\n</description>\n<location>\n/path/to/my-skill/SKILL.md\n</location>\n</skill>\n</available_skills>\n```\n\nThe `<location>` element tells the agent where to find the full skill instructions.\n\n## License\n\nMIT License\n","readmeFilename":"README.md"}