# @frontmcp/skills 中文文档

规范地址：https://npmcn.com/package/%40frontmcp/skills/

版本：1\.12\.2
npm 元数据更新时间：2026-11-14T21:12:36.385Z
中文译文更新时间：2026-11-15T15:17:09.549Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40frontmcp/skills
原文对照：https://npmcn.com/package/%40frontmcp/skills/?lang=original
项目主页：https://frontmcp.dev/reference/cli#skills
源码仓库：https://github.com/agentfront/frontmcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.9 MB，414 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：1 个
- 首次发布：2026-03-27T18:38:34.868Z
- 最新版本发布：2026-11-14T21:12:36.023Z
- 近 30 天下载量：6845（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：90（近 12 个月 90 个）

## 中文简介

FrontMCP的技巧目录:SKILL.md 指令,教代码代理构建,测试和部署FrontMCP服务器

## 安装

```sh
npm install @frontmcp/skills
```

也可以使用：`pnpm add @frontmcp/skills`、`yarn add @frontmcp/skills`、`bun add @frontmcp/skills`

## README

# @ frontmcp/ 技能

FrontMCP的技能目录:指令的文件夹(`SKILL.md`、参考文献和实例),用于教授编码代理, 例如克洛德代码或Codex,如何构建,测试和部署FrontMCP服务器. 这个 `frontmcp` CLI读来安装 技能进入您的项目; 您很少自己安装此软件包 .

[![npm](https://img.shields.io/npm/v/@frontmcp/skills.svg)](https://www.npmjs.com/package/@frontmcp/skills) [![License](https://img.shields.io/npm/l/@frontmcp/skills.svg)](https://github.com/agentfront/frontmcp/blob/main/LICENSE)

## 安装技能

使用取决于此软件包的 CLI :

```bash
npx frontmcp skills list                            # the catalog, by category
npx frontmcp skills search "openapi"                # rank skills by a query
npx frontmcp skills install create-tool             # copy one skill into .claude/skills/
npx frontmcp skills install --all --provider codex  # every skill, into .codex/skills/
npx frontmcp skills read create-tool quick-start    # print a skill or one of its references
```

`frontmcp create` 副本 `recommended` 捆绑到一个新项目中( e)`--skills recommended|minimal|full|none`),以及 `nx g @frontmcp/nx:server` 一样 `--skills` 选项。 见 [技能](https://frontmcp.dev/reference/cli#skills) 每个选项的 CLI 引用.

## 目录

| 技能 | 封面 |
| --- | --- |
| `create-tool` | 建筑物、改变或审查a `@Tool` |
| `frontmcp-setup` | 创建并组织一个项目:脚手架、 Nx、 多个应用程序 |
| `frontmcp-development` | 资源、提示、代理、提供者、工作、工作流程、技能 |
| `frontmcp-config` | `frontmcp.config` 财务报告和审定财务报表 `@FrontMcp` 选项: 认证、 传输、 HTTP、 会话 |
| `frontmcp-authorities` | 对工具、资源、提示和技能的授权和准入控制 |
| `frontmcp-auth-ui` | 用自己的组件替换内置的 OAuth 登录和同意页面 |
| `frontmcp-channels` | 将通知和活动推进客户端会话 |
| `frontmcp-extensibility` | 将第三方包件和服务纳入供应商和工具 |
| `frontmcp-observability` | 追踪、结构化伐木、计量和监测 |
| `frontmcp-testing` | 单元、集成和E2E测试 `@frontmcp/testing` |
| `frontmcp-deployment` | 建立目标并部署到Node、Vercel、Lambda和Cloudflare |
| `frontmcp-production-readiness` | 制作前审计和上线核对表 |
| `frontmcp-guides` | 端到端行走和参考项目 |

## 从代码读取目录

```bash
npm install @frontmcp/skills
```

```ts
import { getSkillsByBundle, loadManifest, resolveSkillPath } from '@frontmcp/skills';

const manifest = loadManifest();
for (const skill of getSkillsByBundle(manifest.skills, 'minimal')) {
  console.log(skill.name, resolveSkillPath(skill));
}
```

`loadManifest()` 读取 `catalog/skills-manifest.json` 从已安装的软件包. `getSkillsByTarget`, (中文(简体) ), `getSkillsByCategory`, (中文(简体) ), `getInstructionOnlySkills` 财务报告和审定财务报表 `getResourceSkills` 过滤其 `skills`,以及 `resolveSkillPath` 返回一个技能文件夹的绝对路径.

## 文档

-   [技能命令](https://frontmcp.dev/reference/cli#skills) cLI 参考文献
-   [给代理人的文档](https://frontmcp.dev/learn/docs-for-your-agent):FrontMCP的Docs over MCP, 为了释放你 使用情况
-   [在自己的服务器中的技能](https://frontmcp.dev/reference/sdk/skill)数字 : `@Skill`,为 MCP 客户提供技能

## 相关软件包

-   [`frontmcp`](https://www.npmjs.com/package/frontmcp) ——落后的CLI `frontmcp skills` 财务报告和审定财务报表 `frontmcp create --skills`
-   [`@frontmcp/nx`](https://www.npmjs.com/package/@frontmcp/nx) - Nx服务器生成器,它也安装技能
-   [`@frontmcp/sdk`](https://www.npmjs.com/package/@frontmcp/sdk) 技能描述的框架

## 捐款

资料来源: [`libs/skills`](https://github.com/agentfront/frontmcp/tree/main/libs/skills)问题和拉动请求 欢迎;见 [捐款额](https://github.com/agentfront/frontmcp/blob/main/CONTRIBUTING.md)。对FrontMCP的修改 行为在同一拉力请求中更新匹配技能.

### 结构

大多数技能是 **路由器技能**(单位:千美元) `SKILL.md` 带有路由表,a `references/` 专题指南目录,以及 选项 `examples/<reference-name>/` 目录. `create-tool` 是一个 **组成部分技能** (单位:千美元)`layout: component`: 平顶 `examples/` 医生/医生 `rules/`。 。 。 .

```text
catalog/
├── skills-manifest.json       # Machine-readable index, generated from the SKILL.md files
├── TEMPLATE.md                # Starting point for a new SKILL.md
├── create-tool/               # Component skill: references/, examples/, rules/
├── frontmcp-setup/            # Router skills: SKILL.md, references/, examples/
├── frontmcp-development/
├── ...                        # One directory per skill in the table above
└── frontmcp-guides/
```

每个路由器技能目录都遵循此格式:

```text
frontmcp-development/
├── SKILL.md          # Required: frontmatter + routing table + instructions
└── references/       # Reference files with detailed per-topic guides
    ├── create-resource.md
    ├── create-agent.md
    └── ...
```

实例文件在 `examples/<reference-name>/` 并且是实例元数据使用的单词源 `skills-manifest.json` 和参考文献 `## Examples` 图表.

### SKILL.Md 前题

```yaml
---
name: my-skill # Required: kebab-case, max 64 chars
description: What the skill does # Required: short description
tags: [setup, redis] # Optional: categorization tags
tools: # Optional: tool references
  - tool_name
  - name: detailed_tool
    purpose: Why this tool is used
    required: true
parameters: # Optional: input parameters
  - name: param_name
    description: What it controls
    type: string
    default: value
examples: # Optional: usage examples
  - scenario: When to use this
    expected-outcome: What happens
priority: 5 # Optional: search ranking weight
visibility: both # Optional: mcp | http | both
compatibility: Node.js 24+ # Optional: environment requirements
license: MIT # Optional: license
allowed-tools: Read Edit # Optional: pre-approved tools
rating: 4.5 # Optional (v1.2): 0..5 quality rating, surfaced via Skills HTTP API min-rating filter
category: development # Optional (v1.2): catalog category override (defaults to the directory's parent category)
requires: [frontmcp-setup] # Optional (v1.2): other skill names this depends on; resolver registers deps first
---
# Skill Instructions

Step-by-step markdown instructions here...
```

### 添加新技能

比起创建新的顶级技能目录,更倾向于添加对现有技能的参考.

1.  识别您内容所属的技能(参见 [目录](https://npmcn.com/package/%40frontmcp/skills/#readme-the-catalog)(中文(简体) )
2.  创建新 `.md` 该技能中的参考文件 `references/` 目录
3.  在技能中添加一个路由条目 `SKILL.md` 路由表
4.  以 `node libs/skills/scripts/generate-manifest.mjs` (单位:千美元)`nx build skills` 也运行它)
5.  运行 `nx test skills` 用于验证

对于新的顶级技能,从 `catalog/TEMPLATE.md`。 。 。 .

### 添加示例文件

每个引用都可能有匹配 `examples/<reference-name>/` 带有独立实例文件的目录.

```yaml
---
name: example-name
reference: parent-reference-name
level: basic
description: One sentence describing the exact scenario this example covers.
tags: [keyword1, keyword2, keyword3]
features:
  - Concrete API or pattern this example demonstrates
  - Another concrete behavior shown in the code
---
```

规则:

-   `name` 必须在没有 `.md`
-   `reference` 必须匹配父示例目录
-   `description` 是由表和参考表重复使用的单行单线摘要
-   `tags` 可搜索的示例关键字
-   `features` 是代码显示的混凝土 API 或图案
-   H1第1段应该一致 `description`

### 突出条目

每个技能都有相应的条目 `skills-manifest.json`生成的 `SKILL.md`数字 :

```json
{
  "name": "frontmcp-development",
  "category": "development",
  "description": "Domain router for building MCP components",
  "path": "frontmcp-development",
  "targets": ["all"],
  "hasResources": true,
  "tags": ["router", "development", "tools", "resources"],
  "bundle": ["recommended", "minimal", "full"]
}
```

#### 目标值

-   `all` - 适用于所有部署目标
-   `node` - 节点js/多克部署
-   `vercel` ——无Vercel服务器
-   `lambda` - AWS Lambda(英语:
-   `cloudflare` ——云花岗工人

#### 组合值

-   `recommended` ——列入默认脚手架
-   `minimal` 列入最低限度脚手架
-   `full` - 只在脚手架上

### 验证

```bash
node libs/skills/scripts/generate-manifest.mjs --check   # the manifest matches the catalog
nx test skills
```

测试验证 :

-   所有 SKILL.md 文件分析正确
-   显示项匹配文件系统( 无孤儿)
-   显示和前题的名称匹配
-   `hasResources` 旗帜是准确的
-   目标、类别和捆绑使用有效值
-   示例元数据在示例文件、参考表格和清单之间保持同步

## 许可证

阿帕奇2.0 (英语). 见 [自由主义](https://github.com/agentfront/frontmcp/blob/main/LICENSE)。 。 。 .

## 常见问题

### @frontmcp/skills 是什么？

FrontMCP的技巧目录:SKILL\.md 指令,教代码代理构建,测试和部署FrontMCP服务器

### 如何安装 @frontmcp/skills？

在项目目录运行 npm install @frontmcp/skills，或使用 pnpm add / yarn add / bun add。

### @frontmcp/skills 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @frontmcp/skills 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @frontmcp/skills 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @frontmcp/skills 可以商用吗？

@frontmcp/skills 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @frontmcp/skills 的下载量有多少？

根据 npm 官方下载统计，@frontmcp/skills 在 2026/10/16 – 2026/11/14 这 30 天内被下载 6,845 次，日均约 228 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @frontmcp/skills 还在维护吗？

最新版本 1\.12\.2 发布于 2026/11/15（1 天前）；至今共发布 90 个版本，其中过去 12 个月发布了 90 个；首次发布于 2026/03/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。