# MetaSkills

MetaSkills is an open-source toolkit of portable, installable skills for building better AI agents, reusable workflows, and agent capabilities directly inside downstream repositories.

Website: https://movetheneedle.info/metaskills/
GitHub: https://github.com/smota/metaskills
License: https://github.com/smota/metaskills/blob/main/LICENSE

## What it is

MetaSkills packages agent-building and skill-authoring practices as readable files: SKILL.md, README files, templates, checklists, references, and examples. It helps teams avoid starting from blank prompts and makes agent practices inspectable and version-controlled.

## What it is not

MetaSkills is not a hosted AI platform, runtime, management control plane, deployment service, or issue tracker for downstream projects.

## Audience

- AI engineers
- open-source maintainers
- developer tooling builders
- prompt and agent framework creators
- teams using OpenAI/Codex-style agents, Claude, GitHub Copilot, Gemini, or similar tools

## Current skills

- agent-builder: builds portable agent definitions from plain-language goals.
- skill-creator: creates, evaluates, improves, benchmarks, and evolves reusable skills.
- harness-validator: performs read-only, evidence-first audits of the working system around AI coding agents across nine categories and 78 checks.

## Important repository paths

- /README.md: main project overview and install commands.
- /skills/agent-builder/: installable skill for creating agents.
- /skills/skill-creator/: installable skill for creating and improving skills.
- /skills/harness-validator/: installable skill for auditing agent harness reliability, safety, verification, continuity, and orchestration.
- /examples/: public examples showing expected use.
- /docs/interoperability.md: compatibility and trust model.
- /CONTRIBUTING.md: contribution pathway.

## Install

List available skills:

```bash
npx skills add https://github.com/smota/metaskills --list --full-depth
```

Install a skill:

```bash
npx skills add https://github.com/smota/metaskills --skill agent-builder --full-depth
npx skills add https://github.com/smota/metaskills --skill skill-creator --full-depth
npx skills add https://github.com/smota/metaskills --skill harness-validator --full-depth
```