Skip to main content

Skills (SKILL.md)

AgentOS supports skills: modular prompt modules defined by a SKILL.md file.

Skills are intended to complement tools/extensions:

  • Tools are atomic operations (ITool) that the runtime can execute.
  • Skills are higher-level instructions/workflows injected into the agent’s prompt.

File format​

Each skill lives in its own folder containing SKILL.md:

---
name: github
description: Use the GitHub CLI (gh) for issues, PRs, and repos.
metadata:
  agentos:
    emoji: "🐙"
    primaryEnv: GITHUB_TOKEN
    requires:
      bins: ["gh"]
    install:
      - id: brew
        kind: brew
        formula: gh
        bins: ["gh"]
---

# GitHub (gh CLI)

Use the `gh` CLI to interact with GitHub repositories.

Runtime API​

Load skills from one or more directories:

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

const registry = new SkillRegistry();
await registry.loadFromDirs(['./skills']);

const snapshot = registry.buildSnapshot({ platform: process.platform });
console.log(snapshot.prompt);

Source: SkillRegistry, SkillLoader.

Curated registry (optional)​

The curated content currently includes 88 skills spanning developer tools, productivity, information, communication, memory, social media, and voice. See @framers/agentos-skills/registry.json for the canonical list and registry/curated/ for the SKILL.md content.

@framers/agentos-skills-registry supports two usage modes:

Agents can discover curated skills via the Capability Discovery Engine (@framers/agentos/discovery), which indexes them as CapabilityDescriptor entries with kind: ‘skill’. The SkillRegistry from @framers/agentos/cognition/skills (the engine) provides skills_list, skills_read, skills_enable, skills_status, and skills_install tools directly. Curated skill content (the SKILL.md files) ships in @framers/agentos-skills.

Agentic discovery​

Skills are discoverable at runtime via: