@framers/agentos-skills

Curated SKILL.md prompt modules for AgentOS — 88 staff-verified skills with a machine-readable registry index.

npm install @framers/agentos-skills

This is the content package. It contains 88 curated SKILL.md files and the generated registry.json index, with no dependencies. Its runtime code is index.mjs, which reads registry.json and exports it.

For the catalog SDK (query helpers, lazy loading, factory functions), see @framers/agentos-skills-registry.

For the runtime engine (SkillLoader, SkillRegistry, path utilities), see @framers/agentos (@framers/agentos/cognition/skills, also re-exported from the package root).

What's Inside

This package bundles 88 curated SKILL.md files under registry/curated/: 82 in their own directories and six game skills under registry/curated/game/. registry.json gives each one of these categories:

Each skill is a Markdown file with YAML frontmatter:

---
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...]

That is the github skill's frontmatter, with requires_tools cut short. Under metadata.agentos, a skill can also set primaryEnv, os, requires (bins, anyBins, env, config) and install steps; the runtime engine checks requires when a snapshot is built with strict: true.

Ecosystem

@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)

This layout mirrors the extensions ecosystem: @framers/agentos-extensions (content) + @framers/agentos-extensions-registry (SDK).

Usage

The registry index

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}`);
}

The default export is the parsed registry.json. Importing @framers/agentos-skills/registry.json directly needs the JSON import attribute (with { type: 'json' }) on Node.

Via the catalog SDK (recommended)

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

Via the runtime engine

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() reads the SKILL.md of each directory directly under a listed directory, so the game skills need registry/curated/game listed too.

Contributing

See CONTRIBUTING.md for guidelines on adding new skills.

License

Apache 2.0 — see LICENSE.

Built by Frame
Contact: [email protected]