@ framers/ 代理技能

用于 AgentOS 的已校验 SKILL.md 提示模块 88名工作人员通过机器可读登记册索引核查的技能.

npm install @framers/agentos-skills

这是内容包. 里面有88个编译的SKILL.md档案和 生成 registry.json 指数,没有依赖关系。 它的运行时间代码是 index.mjs,其内容如下: registry.json 并出口出来.

给 目录 SDK (清仓助工,懒散装卸,工厂功能),参见: @framers/agentos-skills-registry。 。 。 .

给 运行时引擎 (SkillLoader、SkillRegistry、路径公用事业),见 @framers/agentos (单位:千美元)@framers/agentos/cognition/skills,也可以从包根再出.

里面的东西

此软件包捆绑 88个整理的SKILL.md文件 下级 registry/curated/: 82 在自己的目录和6个游戏技能下 registry/curated/game/。 。 。 . registry.json 给予其中每个类别:

每个技能都是带有 YAML 前题的 Markdown 文件 :

---
name: github
version: '2.0.0'
description: Full GitHub API integration — 26 tools for repos, issues, PRs, branches, commits, releases, Actions, files, gists, and codebase indexing.
author: Wunderland
namespace: wunderland
category: developer
tags: [github, git, repository, issues, pull-requests, code-review, ci-cd, releases, actions, api]
requires_secrets: [github.token]
requires_tools: [github_search, github_repo_list, github_repo_info, ...]
metadata:
  agentos:
    emoji: "\U0001F4BB"
---

# GitHub

[Markdown instructions for the agent...]

这是 github 技能的前题 requires_tools 剪短时间。 下 metadata.agentos,一个技能也可以设置 primaryEnv, (中文(简体) ), os, (中文(简体) ), requires (单位:千美元)bins, (中文(简体) ), anyBins, (中文(简体) ), env, (中文(简体) ), config和 install 步骤; 运行时引擎检查 requires 当一个快照用 strict: true。 。 。 .

生态系统

@framers/agentos/cognition/skills     ← Engine (SkillLoader, SkillRegistry, path utils)
@framers/agentos-skills               ← Content (you are here — 88 SKILL.md files + registry.json)
@framers/agentos-skills-registry      ← Catalog SDK (SKILLS_CATALOG, query helpers, factories)

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

使用量

登记册索引

import registry from '@framers/agentos-skills';

console.log(`${registry.stats.totalSkills} skills available`);
for (const skill of registry.skills.curated) {
  console.log(`  ${skill.metadata?.emoji ?? '📦'} ${skill.name} — ${skill.description}`);
}

默认导出为解析 registry.json。导入 @framers/agentos-skills/registry.json 直接需要 JSON 导入属性(with { type: 'json' }) 在节点上.

通过目录SDK(建议)

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

const matches = searchSkills('github');
const skill = await loadSkillByName('github');
console.log(skill?.content); // SKILL.md body ready for prompt injection

通过运行时引擎

import { SkillRegistry } from '@framers/agentos/cognition/skills';

const registry = new SkillRegistry();
await registry.loadFromDirs([
  '/path/to/agentos-skills/registry/curated',
  '/path/to/agentos-skills/registry/curated/game',
]);
const snapshot = registry.buildSnapshot({ platform: 'darwin', strict: true });
console.log(snapshot.prompt);

loadFromDirs() 读取 SKILL.md 每个目录直接放在列表下,所以游戏技能需要 registry/curated/game 名单也列出.

捐款

见 捐款额 关于增加新技能的准则.

许可证

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

由 框架
联系人 : 团队@frame.dev