Vibe-Skills is a free, open source automation project written in Python and released under Apache-2.0. It has 3,329 GitHub stars, 287 forks and 42 open issues, and was last pushed 17 days ago. On this registry it ranks #35 of 54 tracked projects in Automation, with 5 head-to-head comparisons available. It gained 27 stars over the last 3 tracked days.

What is Vibe-Skills?

What it is

Vibe-Skills is a Python, Apache-2.0 project for intelligent skill routing and workflow orchestration for AI agents. It is positioned in the agentic coding and developer-tools ecosystem, with topics that include agent-framework, agent-skills, ai-agents, claude-code, codex, and context-engineering.

The concrete problem it addresses is that agents can face a large installed pool of specialized Skills while still needing to discover, select, and organize the relevant ones for a complex professional task. Without that routing and orchestration step, agents may misunderstand the task, omit steps, choose incorrect Skills, or repeat tool calls and context processing. The project presents itself as a planning and execution layer that first clarifies the objective and delivery requirements, then decomposes work into verifiable subtasks.

Key capabilities

  • It reviews configured Skill folders and SKILL.md files to choose a small set of relevant Skills from a larger candidate pool.
  • It decomposes a complex task into verifiable subtasks after clarifying the task objective and delivery requirements.
  • It arranges selected work into groups and work units, then executes them in an order determined by their dependencies.
  • It runs pre-delivery and final checks across data, experiment results, figures, reports, and slides, including required files, cross-deliverable consistency, and core reproduction.
  • It is designed for large-scale multi-Skill environments, including a SkillsBench setting where every task sees all 195 specialized Skills.

Who uses it and how

  • Researchers and agent developers can use it to evaluate whether an agent can autonomously discover, select, and orchestrate Skills from a large installed pool on SkillsBench.
  • Agentic coding users can apply it to complex tasks that require planning, dependency-aware execution, and verification before delivery.
  • Scientific or data-analysis workflows can use it to produce auditable outputs such as a data audit, statistical review, result figures, a report, and a slide deck.

Getting started

The README excerpt references v4.1.0 and a quick start, but it does not state a package manager, Docker image, hosted option, or deployment command. The measured setup uses DeepSeekV4Flash-VE and OpenHands as the baseline evaluation environment.

When to use it — and when not to

It is most useful when an agent must operate across many installed Skills and needs routing, decomposition, dependency-aware execution, and verification for complex deliverables. It is less suitable when a project requires a documented install path, hosted option, or self-hosted infrastructure guidance, because the excerpt provides none. The reported gains are tied to SkillsBench with DeepSeekV4Flash-VE and OpenHands, so other models, tasks, or agent stacks may not show the same effect.

project readme (upstream, from github) — read inline

English | 中文


Latest release · v4.1.0

Quick start ·

Measured on SkillsBench

Mean verifier reward: +21.12 pp
Total tokens: -29.6% · Tool calls: -33.1%

SkillsBench is a benchmark designed to evaluate whether AI agents can effectively use Skills to complete professional tasks across diverse domains. Its purpose is to measure how much a model’s ability to solve complex real-world tasks improves when it is equipped with specialized Skills.

To evaluate performance in production-like environments where a large number of Skills are installed simultaneously, we adapted SkillsBench into a more realistic large-scale multi-Skill setting. In the original SkillsBench setup, each task is provided only with the specialized Skill associated with that task. In our modified setting, every task is evaluated in a global environment containing all 195 specialized Skills, while all other experimental conditions remain unchanged. This setting is intended to assess whether an agent can autonomously discover, select, and orchestrate the relevant Skills from a large installed Skill pool, and organize them into an effective workflow for completing complex tasks.

vibeskills v4.1.0 was benchmarked on SkillsBench (https://www.skillsbench.ai/) using DeepSeekV4Flash-VE and OpenHands as the baseline evaluation setup. Compared with the baseline without vibeskills, vibeskills increased the average task score by 21.12%, while reducing token consumption by 29.6% and tool calls by 33.1%.

Task quality: 39 to 57 full-score tasks; Lean Vibe scored higher on 23 tasks, Native on 4, with 55 ties.

Resource use: 491.122M to 345.756M total tokens, with tool calls reduced from 9,954 to 6,664.

Analysis of the logs from the original benchmark shows that VibeSkills achieves better task performance not by invoking more Skills.

Instead, it first clarifies the task objective and delivery requirements, then decomposes a complex task into several verifiable subtasks. It subsequently selects only a small number of truly relevant capabilities from a large pool of candidate Skills and executes them in an order determined by their dependencies. This helps reduce misunderstandings of the task, omitted steps, and incorrect Skill selection, thereby improving overall task performance.

In terms of token cost and tool usage, this workflow also eliminates a substantial amount of ineffective trial and error. Native agents are more likely to repeatedly invoke tools in unproductive directions, reread the same context, and redo previous work. In contrast, VibeSkills converges more quickly on the critical steps through clearer planning and pre-delivery checks. As a result, it not only improves task quality, but also significantly reduces tool-call loops and the token overhead caused by repeated context processing.

Study, public data, and reproduction ·

Task

Use public data to complete a reproducible classification experiment and deliver a data audit, statistical review, 4 result figures, a scientific report, and a 7-slide group-meeting deck.

The diagram shows what happened after the requirement and plan were approved: how the task was executed, what it produced, and how the result was checked.

The task used the L workflow and proceeded in order. During publication preparation, the configured folders on the same host contained more than 100 Skills. VibeSkills reviewed the candidates and their SKILL.md files, selected 7 for this task, and arranged the work into 5 groups and 10 work units. Those units covered environment setup, data audit, modeling, statistical review, figures, the report, and the slide deck.

After the work finished, VibeSkills ran 17 checks across the data, experiment results, figures, report, and slides. The task passed final acceptance after the required files, cross-deliverable consistency, and core reproduction all passed.

7 Skills selected · 5 work groups · 10 / 10 work units completed · 17 / 17 checks passed

%%{init: {"flowchart": {"curve": "monotoneX", "nodeSpacing": 18, "rankSpacing": 36}}}%%
flowchart LR
    subgraph DISC["Skill discovery"]
        direction TB
        A["Configured Skill folders<br/>100+ Skills"]
        B["Shortlist candidates<br/>Read SKILL.m

readme truncated — read the full docs on github

Frequently asked questions

Is Vibe-Skills free to use?

Vibe-Skills is open source under the Apache-2.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does Vibe-Skills do?

Intelligent Skill routing and workflow orchestration for AI agents — +21.12 pp reward, −29.6% tokens on SkillsBench with DeepSeekV4Flash-VE.

What is Vibe-Skills written in?

Vibe-Skills is primarily written in Python. Its source is publicly available at https://github.com/foryourhealth111-pixel/Vibe-Skills, and it has 3,329 GitHub stars.