An open API service indexing awesome lists of open source software.

https://github.com/ellmos-ai/skills

Portable SKILL.md library for Claude Code, Codex-compatible agents, BACH, and local-first LLM workflows
https://github.com/ellmos-ai/skills

agent-framework agent-skills ai-skills anthropic automation bach claude-code claude-skills codex-skills llm llm-agents llm-tools local-first open-source portable-skills python skill-library skill-md sqlite

Last synced: 2 days ago
JSON representation

Portable SKILL.md library for Claude Code, Codex-compatible agents, BACH, and local-first LLM workflows

Awesome Lists containing this project

README

          

ellmos skills Banner

# ellmos skills

**[🇩🇪 German version](README_de.md)** · **🇬🇧 English** · [Machine-readable context](llms.txt)

> Portable AI skill library for Claude Code-style `SKILL.md` workflows, Codex-compatible agent setups, BACH, and other local-first LLM agent runtimes.

[![License: MIT](https://img.shields.io/badge/License-MIT-green)](LICENSE)

**Quick links:** [Start Here](#start-here) · [Featured Skills](#featured-skills) · [Skills](skills/) · [Skills Map](SKILLS-MAP.md) · [Conventions](docs/CONVENTIONS.md) · [Changelog](CHANGELOG.md)

This repository is the reusable skill catalog of the ellmos ecosystem. It contains standalone process skills, development workflows, research helpers, therapy-oriented methods, infrastructure playbooks, and utility tools in an Anthropic-compatible `SKILL.md` format. Each skill carries its own metadata directly in YAML frontmatter, so runtimes can inspect provenance, compatibility, and dependencies without a central registry.

## Start Here

| Need | File or command |
|---|---|
| Browse all public skills | [`skills/`](skills/) |
| See a tree map of every tracked skill | [`SKILLS-MAP.md`](SKILLS-MAP.md) |
| Understand the `SKILL.md` schema | [`docs/CONVENTIONS.md`](docs/CONVENTIONS.md) |
| Machine-readable catalog index | [`registry/components.json`](registry/components.json) |
| Browse by category | [`skills/`](skills/) (one subfolder per category) |
| Use a skill | Copy `skills///` into your agent's skills directory (e.g. `~/.claude/skills/`) |
| Review public changes | [`CHANGELOG.md`](CHANGELOG.md) |
| Give crawlers and LLM agents a compact map | [`llms.txt`](llms.txt) |

## Catalog Snapshot

The current public catalog contains 77 tracked runtime skills:

| Category | Count | Focus |
|---|---:|---|
| `assist` | 9 | Personal-assistant skills: weather, routing, location search, calendar, news digest, transcription, medical self-tracking, dossier scaffolding, dev assistant |
| `dev` | 13 | Development protocols, debugging, bug sweeps, pipeline renovation, migration, documentation, plugin systems, repository publication |
| `education` | 4 | Academic planning, source-based learning, exam preparation, and a support-worksheet generator pointer skill |
| `game-dev` | 5 | Blender, Roblox, Rojo, Studio, asset safety, and game-design workflows |
| `infrastructure` | 6 | Portable AI setup, skill landscape management, MCP config sync between agent apps |
| `production` | 1 | Text production router: general texts, narrative stories, PR with a local LaTeX press-release compiler |
| `research` | 1 | Research-agent workflow support |
| `therapy` | 19 | German-language psychoeducation and counseling method playbooks |
| `utilities` | 18 | Batch operations, thinking frameworks, decision briefings, document chunking, encoding repair, video transcripts, private-mail drafting, job-application support, German-law and German-tax first-look pointer skills |
| `web` | 1 | Web-reading protocol support |

## Featured Skills

Some skills are especially useful as entry points because they coordinate other tools, prevent messy agent workflows, or turn local procedures into repeatable playbooks:

| Skill | Why it stands out |
|---|---|
| [`skill-explorer`](skills/infrastructure/skill-explorer/SKILL.md) | Meta-skill for managing the skill landscape: audits existing skills, clusters them into families, researches external skills/plugins, and installs only after safety review and explicit approval. |
| [`model-strategy`](skills/dev/model-strategy/SKILL.md) | Multi-model routing for Claude, Codex, Gemini, and Ollama with score-based selection, delegation paths, escalation triggers, and cost/quality tradeoffs. |
| [`pipeline-optimizer`](skills/dev/pipeline-optimizer/SKILL.md) | Six-step renovation protocol for existing project folders, documentation systems, and software stacks; designed to avoid duplicate standards and broken workflows. |
| [`github-repo-care`](skills/dev/github-repo-care/SKILL.md) | Publication and maintenance gate for GitHub repos: local rules, locks, `.gitignore`, privacy checks, README/i18n, releases, and repository metadata. |
| [`mcp-config-sync`](skills/infrastructure/mcp-config-sync/SKILL.md) | Synchronizes MCP server configuration between Claude Code and Claude Desktop with a shared master file and Windows/macOS helper scripts. |
| [`video-transcriber`](skills/utilities/video-transcriber/SKILL.md) | Extracts video subtitles/transcripts plus metadata (supports YouTube sources) into Markdown, JSON, or plain text so video analysis starts from source-backed text. |
| [`rbx-studio`](skills/game-dev/rbx-studio/SKILL.md) | Roblox Studio operation: Explorer/Play-Test workflow, Rojo scene-vs-code hookup, AI control of Studio via MCP, and a mandatory malware scan for Creator Store assets. |
| [`decision-briefing`](skills/utilities/decision-briefing/SKILL.md) | Turns many open decisions into a numbered A/B/C/D briefing with recommendations, accepts batch replies, and records the chosen outcomes. |
| [`bugsweep`](skills/dev/bugsweep/SKILL.md) | Systematic bug-sweep protocol with a codebase-scaled target count, doubling escalation, area tracking, and completion verification -- turns ad hoc bug hunting into a repeatable, measurable pass. |
| [`plugin-system`](skills/dev/plugin-system/SKILL.md) | Generic auto-discovery plugin system for Python applications: zero dependencies (stdlib only), validation, and fault tolerance for turning your own scripts into a pluggable architecture. |
| [`bilingual-doc-sync`](skills/utilities/bilingual-doc-sync/SKILL.md) | Keeps parallel-language documents (papers, READMEs, `SKILL.md`/`SKILL.en.md` pairs) in sync: detects missing translations and section drift, plus an expansion audit for whether a document deserves further languages. |
| [`trampelpfadanalyse`](skills/dev/trampelpfadanalyse/SKILL.md) | Empirical baseline-intervention-retest method for checking whether an agent convention or README rule is actually visible and followed, using isolated sandbox subagents to measure whether a doc change changed behavior. |
| [`law-checker`](skills/utilities/law-checker/SKILL.md) | Pointer skill to the standalone `ellmos-ai/law-checker` module: source-grounded AI first-look legal assessments for German law with a statute registry and a statute-embodiment agent -- AI orientation only, not a substitute for a lawyer. |
| [`steuer-assistent`](skills/utilities/steuer-assistent/SKILL.md) | Pointer skill to the standalone `ellmos-ai/steuer-assistent` module: an offline-first local worksheet for German employee income-related expenses (Werbungskosten) -- not tax advice, no tax-return filing. |
| [`worksheet-generator`](skills/education/worksheet-generator/SKILL.md) | Pointer skill to the standalone `ellmos-ai/worksheet-generator` module: generates individualized worksheets from a support goal, level, and age for educational/therapeutic professionals, with bring-your-own ICF references -- a material generator, not a therapy program. |
| [`research-agent`](skills/research/research-agent/SKILL.md) | Self-contained scientific literature workflow around PubMed and arXiv (pure Python stdlib) -- turns ad hoc paper hunting into a repeatable, source-backed research pass, fully portable without the ellmos ecosystem. |
| [`agent-config-sync`](skills/infrastructure/agent-config-sync/SKILL.md) | Synchronizes MCP servers and skills across multiple agent apps from one registry with config templates and cache -- addresses the real painpoint of keeping several agent runtimes configured consistently. |
| [`dev-soft-agent`](skills/dev/dev-soft-agent/SKILL.md) | Standalone development-automation pipeline (code analysis, task engine, policies, prompt templates) in zero-dependency Python -- a complete dev-agent workflow without external services. |
| [`llm-text-hygiene`](skills/utilities/llm-text-hygiene/SKILL.md) | Removes AI traces and chat residue from finished texts and handles AI-disclosure levels -- keeps published documents clean of LLM artifacts. |
| [`idea-mining`](skills/utilities/idea-mining/SKILL.md) | Distinctive multi-technique method for mining ideas out of stuck problems -- the structured alternative to free-form brainstorming when a project has hit a wall. |
| [`skill-extractor`](skills/infrastructure/skill-extractor/SKILL.md) | Extracts a reusable skill from a chat history (current session or transcript files) -- turns what just worked into a portable playbook, or improves an existing skill from the evidence. |
| [`workflow-extract`](skills/infrastructure/workflow-extract/SKILL.md) | Builds an automation from a chat history or from existing automation prompts of another agent system -- conversations become repeatable workflows. |
| [`ai-portable-setup`](skills/infrastructure/ai-portable-setup/SKILL.md) | Creates a portable offline AI working environment on a USB stick or any drive: local LLM models and a RAG pipeline, no cloud required. |
| [`bewerbungsexperte`](skills/utilities/bewerbungsexperte/SKILL.md) | End-to-end job-application support: job-ad analysis, CV/LinkedIn optimization, cover letters, plus a database/folder-driven ASCII CV generator (German-language focus). |
| [`therapy/` collection](skills/therapy/) | The 19-skill therapy family (flagships: [`cognitive-restructuring`](skills/therapy/cognitive-restructuring/SKILL.md), [`motivational-interviewing`](skills/therapy/motivational-interviewing/SKILL.md)) -- evidence-cited, bilingual, ethics-gated psychoeducation and counseling method playbooks; the deepest coherent block of the library. |

## Education Skills

Three institution-neutral skills for academic study. Placeholders (``, ``, ``, etc.) are resolved to the concrete context on first use. All three skills are available in German (base) and English; ES, JA, RU, ZH are planned for Stage 2.

| Skill | What it does |
|---|---|
| [`academic-study-control`](skills/education/academic-study-control/SKILL.md) | Semester planning, deadline tracking, exam registration, re-enrollment, mail/portal checks, and calendar reminders with source verification and privacy guardrails. |
| [`academic-study-learn`](skills/education/academic-study-learn/SKILL.md) | Five-phase source-based learning cycle: clarify objective → extract key ideas → build glossary → transfer/apply → retrieval practice with gap tracking. |
| [`academic-study-test`](skills/education/academic-study-test/SKILL.md) | Five test modes (quick test, exam block, oral exam, assignment training, error diagnosis) with a rubric-based assessment system and a strict ethics boundary against live-exam support. |

## Repository Structure

```text
skills/
/
/
SKILL.md # Definition, frontmatter, usage workflow
scripts/ # Optional executable helpers
references/ # Optional supporting documents
_templates/ # Templates for new skills
docs/
CONVENTIONS.md # Frontmatter specification
registry/components.json # Machine-readable catalog index
llms.txt # Compact project map for LLM crawlers
```

## Skill Metadata

Every `SKILL.md` declares whether it works standalone, whether it is compatible with BACH, and where it came from:

```yaml
standalone: true
bach_compatible: true
bach_origin: true
provenance:
origin: "bach"
origin_path: "system/skills/therapie/"
origin_version: "1.0.0"
last_sync_from_origin: "2026-03-12"
last_sync_to_origin: null
local_changes_since_sync: false
```

Supported skill types are `skill`, `agent`, `expert`, `service`, `protocol`, and `tool`.

## Validation

Pull requests and pushes that change a public `SKILL.md` run the complete static
S-test gate. Run the same tracked-skill check locally with:

```bash
python testing/skill_tester.py batch --type static --ci
```

With [pre-commit](https://pre-commit.com/) installed, enable the repository hook
once with `pre-commit install`. It applies the same gate only to changed
`SKILL.md` files before a commit.

## Search Context

Use this repository when searching for:

- `ellmos skills`
- `ellmos-ai/skills`
- `agent skill library`
- `SKILL.md catalog`
- `portable AI skills`
- `Claude Code SKILL.md library`
- `Codex skills library`
- `Claude Code and Codex skills`
- `local-first LLM agent skills`
- `BACH skill catalog`
- `Anthropic-compatible skills`

The name is intentionally generic, so use the canonical repository string `ellmos-ai/skills` when linking or indexing this project. It is a reusable skill catalog, not an MCP server, hosted SaaS marketplace, prompt pack, or private skill installer.

## Related ellmos Projects

| Project | Role |
|---|---|
| [BACH](https://github.com/ellmos-ai/bach) | Full text-based LLM operating system |
| [Rinnsal](https://github.com/ellmos-ai/rinnsal) | Lightweight local-first LLM agent infrastructure |
| [USMC](https://github.com/ellmos-ai/usmc) | Shared memory primitive for agent systems |
| [Gardener](https://github.com/ellmos-ai/gardener) | Database-based operating-system counterpart |
| [MarbleRun / llmauto](https://github.com/ellmos-ai/MarbleRun) | LLM chain-execution framework |

## License

MIT License. See [LICENSE](LICENSE).

## Liability

This project is an unpaid open-source donation. Liability is limited to intent and gross negligence under Section 521 of the German Civil Code. Use at your own risk. No warranty, maintenance guarantee, availability guarantee, or fitness-for-purpose guarantee is provided.