@ framers/ agentos- 技能- 注册

目录SDK 用于查询和装入 AgentOS 技能.

npm install @framers/agentos-skills-registry

给 技能内容 (SKILL.MD文件),见 @framers/agentos-skills。 。 。 .

生态系统

此布局映射扩展生态系统 : @framers/agentos-extensions (内容)+ @framers/agentos-extensions-registry (SDK) (英语).

快速启动

1. 浏览目录( 0 对等分解)

import {
  SKILLS_CATALOG,
  searchSkills,
  getSkillsByCategory,
  getSkillByName,
} from '@framers/agentos-skills-registry/catalog';

// Full-text search
const matches = searchSkills('github');
console.log(matches.map((s) => `${s.name}: ${s.description}`));

// By category
const devSkills = getSkillsByCategory('developer');
console.log(`${devSkills.length} developer skills`);

// By name
const gh = getSkillByName('github');
console.log(gh?.requiredSecrets); // ['github.token']

2. 随需要装入懒惰技能

import { loadSkillByName } from '@framers/agentos-skills-registry';

const skill = await loadSkillByName('github');
if (skill) {
  console.log(skill.content); // SKILL.md body for prompt injection
  console.log(skill.metadata?.emoji); // "octopus"
}

3. 制作技能短片( 需要@ framers/ agentos)

import { createCuratedSkillSnapshot } from '@framers/agentos-skills-registry';

const snapshot = await createCuratedSkillSnapshot({
  skills: ['github', 'web-search', 'notion'],
  platform: 'darwin',
});

// Inject into agent prompt
console.log(snapshot.prompt);

4. 工作空间技能的发现

import {
  discoverWorkspaceSkills,
  mergeWithWorkspaceSkills,
  SKILLS_CATALOG,
} from '@framers/agentos-skills-registry';

// Scan .agents/skills/ for workspace-local skills
const workspace = await discoverWorkspaceSkills();

// Merge with curated (workspace takes priority on name collision)
const merged = mergeWithWorkspaceSkills(SKILLS_CATALOG, workspace);

发现不跟随技能文件夹下方的符号链接. 一个技能文件夹或作为链接的SKILL.md,或者不是普通文件的SKILL.md,都会被一个警告跳过,每个发现的技能的 loadSkill() 读它的文件的方式相同.

分出口

API 参考

目录查询

• SKILLS_CATALOG -- 排序了所有编程 + 社区技能条目
• searchSkills(query) - 在姓名、说明和标签之间进行全文搜索
• getSkillsByCategory(category) -- 按类别过滤
• getSkillByName(name) - 单一技能查询
• getAvailableSkills(installedTools) -- 通过可用工具过滤
• getCategories() -- 列出唯一类别
• getSkillsByTag(tag) -- 通过标签过滤
• getCuratedSkills() 编号 : getCommunitySkills() 编号 : getAllSkills() -- 源过滤器
• getSkillEntries(names) -- 按名称列表过滤( E)'all' | 'none' | string[](中文(简体) )

懒惰装入

• loadSkillByName(name) -- 装入并解析单个 SKILL. md 名称
• loadSkillsByNames(names) - 平行加载多种技能
• createLocalSkillProxy(relativePath, displayName) - 懒装工厂

工厂功能( 需要@ framers/ agentos)

• createCuratedSkillRegistry(options?) - 创建现场 SkillRegistry 具备特定技能
• createCuratedSkillSnapshot(options?) - 建立一个 SkillSnapshot 准备迅速注射

路径助手

• getBundledCuratedSkillsDir() -- 绝对路径 @framers/agentos-skills/registry/curated/
• getBundledCommunitySkillsDir() -- 绝对路径 @framers/agentos-skills/registry/community/

工作空间发现

• discoverWorkspaceSkills(options?) -- -- 扫描 .agents/skills/ 工作空间-当地技能,不遵循下面的象征性链接
• mergeWithWorkspaceSkills(registry, workspace) - 与优先级合并到工作空间
• parseSkillFrontmatter(content) 从技能内容中解析 YAML 前题

捐助和支助

许可证

Apache 2.0 — 见 自由主义。 。 。 .