gitwtfhub

wtf is openskills?

lingyichen-ai/openskills — explained in plain English

Analysis updated 2026-08-04 · repo last pushed 2026-01-30

68PythonAudience · developerComplexity · 3/5QuietSetup · moderate

TL;DR

OpenSkills lets you give AI agents modular skills, like summarizing meetings or processing PDFs, using simple markdown files. The agent loads only what it needs, when it needs it, keeping conversations focused and efficient.

Mindmap

mindmap
  root((repo))
    What it does
      Modular AI skills
      Markdown skill files
      Auto skill discovery
    Progressive disclosure
      Lightweight metadata first
      Detailed instructions next
      Reference docs on demand
    Sandbox and scripts
      Isolated script execution
      Auto file upload download
    AI providers
      OpenAI
      Azure OpenAI
      Ollama
    Use cases
      Meeting summarization
      Office document processing
      Weekly report aggregation
    Audience
      Developers building agents
      Teams needing modular AI

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build an AI assistant that automatically summarizes meeting notes from uploaded transcripts.

REASON 2

Create an agent that processes Word and Excel files to extract and format key data.

REASON 3

Set up a weekly report tool that aggregates multiple documents into one summary article.

REASON 4

Give an AI agent PDF-to-article conversion skills with sandboxed script execution for safety.

What's in the stack?

PythonOpenAIAzure OpenAIOllama

How it stacks up

lingyichen-ai/openskillsdiabloidyobane/driverscopenv-tlabs/artifixer
Stars686868
LanguagePythonPythonPython
Last pushed2026-01-30
MaintenanceQuiet
Setup difficultymoderatemoderatehard
Complexity3/53/55/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires choosing and configuring an AI provider (OpenAI, Azure, or Ollama) and optionally setting up a sandbox environment for running scripts safely.

No license information is provided in the repository, so usage terms are unclear.

Wtf does this do

OpenSkills is a toolkit that lets you give AI agents specialized abilities, like summarizing meetings, processing Word and Excel files, or turning PDFs into articles, without overloading the AI with information it doesn't need at any given moment. You define a skill as a simple markdown file describing what it does, drop in any reference documents or helper scripts, and the framework handles the rest. When a user asks a question, the agent automatically figures out which skill fits and activates it. The core idea is called "progressive disclosure," and it works in three stages. First, the agent only looks at lightweight metadata, a skill's name, description, and trigger words, to decide which skill might be relevant. Once it picks one, it loads that skill's detailed instructions. Only then, if needed, does it pull in specific reference documents or run scripts. This layered approach keeps the AI focused and efficient, rather than dumping every possible instruction and document into the conversation at once. Reference documents can be loaded always, only when a stated condition is met, or at the AI's own discretion based on the question. For anything involving scripts, say, parsing a PDF or generating charts, the project can run them inside an isolated sandbox environment for safety. Files you reference locally get uploaded to the sandbox automatically, and any output files get downloaded back to you. The framework supports several AI providers, including OpenAI, Azure OpenAI, Ollama, and others. This would appeal to developers or teams building AI assistants that need real, modular capabilities rather than just chat. The included examples, meeting summarization, office document processing, weekly report aggregation, give a concrete sense of the use cases. The markdown-based skill format keeps the barrier to entry low, and the auto-discovery of reference files means you can drop documents into a folder and let the AI decide when they're relevant.

Yoink these prompts

Prompt 1
Help me create an OpenSkills markdown skill file for summarizing meeting transcripts. Include a name, description, trigger words, and instructions for the agent to produce a concise summary with action items.
Prompt 2
I want to add an OpenSkills skill that parses Excel files and generates summary charts. Write the skill markdown file and a Python helper script that the sandbox can run safely.
Prompt 3
Set up OpenSkills with Ollama as my AI provider. Show me the configuration steps and a minimal example skill that triggers when a user asks about PDF processing.
Prompt 4
Create an OpenSkills skill that aggregates weekly status reports from multiple Word documents into one formatted summary article. Include reference document loading instructions and trigger keywords.

Frequently asked questions

wtf is openskills?

OpenSkills lets you give AI agents modular skills, like summarizing meetings or processing PDFs, using simple markdown files. The agent loads only what it needs, when it needs it, keeping conversations focused and efficient.

What language is openskills written in?

Mainly Python. The stack also includes Python, OpenAI, Azure OpenAI.

Is openskills actively maintained?

Quiet — no commits in 6-12 months (last push 2026-01-30).

What license does openskills use?

No license information is provided in the repository, so usage terms are unclear.

How hard is openskills to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is openskills for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.