ellmos skills

🇩🇪 German version · 🇬🇧 English · Machine-readable context

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

[!NOTE] AI Agent & LLM Integration: This repository provides standardized SKILL.md files with YAML frontmatter that can be consumed directly by Claude Code, Codex, AGY/Gemini, and custom agent runtimes. See llms.txt for machine-readable context.

[!IMPORTANT] Reading a copy? The canonical, always-current version of this library lives at github.com/ellmos-ai/skills. Forks and mirrors are not updated automatically and may be many commits behind — check the source before relying on anything you read here.

Quick links: Start Here · Featured Skills · Skills · Skills Map · Conventions · Changelog

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.

System Architecture

flowchart TD
    Catalog["catalog.py Registry (104 Skills / 79 Tracked)"] --> Categories
    subgraph Categories ["10 Public Categories"]
        Assist["assist (9)"]
        Dev["dev (15)"]
        Edu["education (4)"]
        Game["game-dev (5)"]
        Infra["infrastructure (6)"]
        Prod["production (1)"]
        Res["research (1)"]
        Therapy["therapy (19)"]
        Utils["utilities (18)"]
        Web["web (1)"]
    end
    Categories --> Specs["SKILL.md (YAML Frontmatter + Playbooks)"]
    Specs --> Runtimes["LLM Runtimes (Claude Code / Codex / AGY / BACH)"]

Start Here

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

Catalog Snapshot

The current public catalog contains 79 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`	15	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`	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`	Multi-model routing for Claude, Codex, Gemini, and Ollama with score-based selection, delegation paths, escalation triggers, and cost/quality tradeoffs.
`pipeline-optimizer`	Six-step renovation protocol for existing project folders, documentation systems, and software stacks; designed to avoid duplicate standards and broken workflows.
`github-repo-care`	Publication and maintenance gate for GitHub repos: local rules, locks, `.gitignore`, privacy checks, README/i18n, releases, and repository metadata.
`mcp-config-sync`	Synchronizes MCP server configuration between Claude Code and Claude Desktop with a shared master file and Windows/macOS helper scripts.
`video-transcriber`	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`	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`	Turns many open decisions into a numbered A/B/C/D briefing with recommendations, accepts batch replies, and records the chosen outcomes.
`bugsweep`	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`	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`	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`	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`	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`	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`	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`	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`	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`	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`	Removes AI traces and chat residue from finished texts and handles AI-disclosure levels -- keeps published documents clean of LLM artifacts.
`idea-mining`	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`	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`	Builds an automation from a chat history or from existing automation prompts of another agent system -- conversations become repeatable workflows.
`ai-portable-setup`	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`	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	The 19-skill therapy family (flagships: `cognitive-restructuring`, `motivational-interviewing`) -- 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 (<INSTITUTION>, <LMS>, <MODULE_PREFIX>, 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`	Semester planning, deadline tracking, exam registration, re-enrollment, mail/portal checks, and calendar reminders with source verification and privacy guardrails.
`academic-study-learn`	Five-phase source-based learning cycle: clarify objective → extract key ideas → build glossary → transfer/apply → retrieval practice with gap tracking.
`academic-study-test`	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

skills/
  <category>/
    <skill-name>/
      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:

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:

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

With pre-commit 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	Full text-based LLM operating system
Rinnsal	Lightweight local-first LLM agent infrastructure
USMC	Shared memory primitive for agent systems
Gardener	Database-based operating-system counterpart
MarbleRun / llmauto	LLM chain-execution framework

License

MIT License. See 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.

Skills

At a glance

README