xiaoxiaofeiya/skillos

SkillOS is a coordination layer for AI coding agents. Modern agents can be extended with many add-on capabilities, called skills, that cover things like running browser tests, deploying apps, reviewing security, or calling external tools. The problem SkillOS addresses is that the more capabilities an agent has installed, the harder it becomes for the agent to notice all of them and choose the right one for a given task. The project provides a command-line tool and an optional server that sit alongside your agent. When you describe what you want, SkillOS helps the agent work out which installed skills apply, in what order to use them, and what safety checks to apply before taking risky actions. Instead of hardcoding which tool to call, you say something like "deploy this app but do not break anything," and SkillOS helps the agent look up what deployment and verification skills are available, then suggest a step-by-step plan. The install has two parts. One part teaches the agent itself when to call SkillOS by registering an entry with whatever agent host you use, such as Claude Code, Cursor, Codex, or Windsurf. The other part installs the local runtime that provides the actual skillos command. The runtime includes a doctor command to check the setup, an inventory command to list installed skills, a recommend command to get suggestions for a given goal, and an explain command to see why a particular choice was made. SkillOS is written in TypeScript and is early in development. The repository includes an install verifier that tests the local setup in isolation without touching real global configuration, which is useful for checking that the install went correctly before using it in a real project. The project is aimed at developers who work with AI coding agents regularly and want the agent to behave more predictably when a large number of capabilities are installed. It does not change how your agent works at the model level, it adds a routing and explanation step on top of whatever skills you already have.