npname
一站式 npm 包名验证与可用性检查工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：npname。 它的用途是：一站式 npm 包名验证与可用性检查工具 完整的 Skill 内容见：https://321skill.com/skills/npname/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我检查一下‘my-awesome-utils’这个 npm 包名是否可用，并验证它是否符合命名规范。” 它会调用 npname 技能，首先离线验证名称的合法性，然后向 npm 注册表发起查询，最终返回一个包含验证结果、可用性状态及详细原因的对象。你还可以要求它批量检查多个候选名称，或生成 JSON 格式的结果以便集成到自动化脚本中。
介绍
npname 解决了开发者在发布 npm 包前，手动验证包名规则和检查注册表可用性的繁琐问题。它提供了一个集成的 JavaScript/TypeScript 库和命令行工具，只需一行代码或命令，即可快速完成包名合规性校验及实时可用性查询。
使用方式非常灵活：可通过 npm 安装库在代码中调用，或全局安装 CLI 工具在终端直接操作。核心 API 包括 validate（离线验证）、checkAvailability（在线检查）和 check（完整验证+检查）。CLI 支持批量查询、JSON 输出、自定义注册表等高级功能。
该工具主要面向需要发布或管理 npm 包的开发者，特别是前端、后端、全栈开发以及智能体开发者。在创建新项目、为开源库命名或管理私有注册表时，它能显著提升效率。
使用建议：对于自动化流程（如 CI/CD），推荐使用 --json 模式以便脚本解析。注意，该库已移除默认导出，需按命名导入 API。检查可用性涉及网络请求，在批处理时请合理设置超时和并发数。
核心特点
与仅提供基础验证的库不同，npname 将严格的 npm 命名规则验证、实时注册表可用性查询、批量处理以及完整的 CLI 工具链整合在一个轻量级包中，并原生支持自定义注册表和认证，提供了开箱即用的企业级解决方案。
注意事项
不适合需要绕过 npm 官方命名规则（如使用保留字或特殊字符）的极端定制化场景。
常见问题
如何检查一个 npm 包名是否已被占用？
使用 `npx npname <包名>` 命令，或通过代码调用 `checkAvailability` 函数，即可查询该名称在 npm 注册表上的实时可用性。
它能验证带 @scope 的包名吗？
可以，npname 完全支持解析和验证符合 npm 规则的带作用域（如 @myorg/package）的包名。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/npname/raw/index.md 读取 npname 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/npname/raw/index.md（查看排版版本）