@ frontmcp/ 技能

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

安装技能

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

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 选项。 见 技能 每个选项的 CLI 引用.

目录

从代码读取目录

npm install @frontmcp/skills

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 返回一个技能文件夹的绝对路径.

文档

• 技能命令 cLI 参考文献
• 给代理人的文档:FrontMCP的Docs over MCP, 为了释放你 使用情况
• 在自己的服务器中的技能数字 : @Skill,为 MCP 客户提供技能

相关软件包

• frontmcp ——落后的CLI frontmcp skills 财务报告和审定财务报表 frontmcp create --skills
• @frontmcp/nx - Nx服务器生成器,它也安装技能
• @frontmcp/sdk 技能描述的框架

捐款

资料来源: libs/skills问题和拉动请求 欢迎;见 捐款额。对FrontMCP的修改 行为在同一拉力请求中更新匹配技能.

结构

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

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/

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

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 前题

---
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. 识别您内容所属的技能(参见 目录(中文(简体) )
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>/ 带有独立实例文件的目录.

---
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数字 :

{
  "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 - 只在脚手架上

验证

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

测试验证 :

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

许可证

阿帕奇2.0 (英语). 见 自由主义。 。 。 .