The "App Store" for your AI Agent.
Discover, install, and map thousands of new capabilities instantly with one click.
Your AI Agent is strong, but it can be even stronger.
OneSkill is the bridge connecting your Agent to the massive OpenSkills ecosystem (which can be complex to navigate and install manually). By installing just this one tool, your Agent gains the ability to evolve itself: discover new skills, install them more easily, and support a wide range of tools like Codex, Gemini, and more.
No more manual file downloads or configuration edits. Everything is automated.
- Massive Skill Library: Instantly connect to thousands of community-maintained Skills (Web browsing, Database management, Code auditing, Cloud infrastructure ops, etc.).
- One-Click Installation: A single command handles downloading, dependency resolution, and environment configuration.
- Perfect Gemini Adaptation: Developed the
mapfeature for Gemini CLI, automatically injecting Skills downloaded via OpenSkills into Gemini's path.
# Install the core tool
npx openskills install xu-xiang/oneskill --global
# (Only required for Gemini users) Map OneSkill itself to .gemini
npx oneskill map --target gemini --globalOnce installed, simply ask your Agent (Claude Code, Codex, Gemini-cli, etc.) to find and recommend suitable skills or use natural language to have it check for a skill to solve the problem at hand. OneSkill will handle the rest.
You don't even need to leave the chat window. Just tell your Agent what you need, and let OneSkill do the heavy lifting.
The following real chat record shows how an Agent instantly gains FastAPI development capabilities via OneSkill:
> Find me a production-ready template for FastAPI. I want to build a project quickly.
✦ Sure, I'll use oneskill to search for relevant Skills.
╭── Shell: npx oneskill search "fastapi template" ───────────────────────────╮
│ │
│ { │
│ "items": [
│ {
│ "slug": "wshobson-fastapi-templates", │
│ "description": "Production-ready FastAPI project structures...", │
│ "repository": "wshobson/agents", │
│ "stars": 23027 │
│ }
│ ]
│ }
╰────────────────────────────────────────────────────────────────────────────╯
✦ Found `wshobson-fastapi-templates` in the `wshobson/agents` repository.
This is a very popular Skill (23k+ stars) that provides a production-grade project structure. Would you like me to install it for you?
> Yes, install it.
✦ Installing and configuring for Gemini...
╭── Shell: npx openskills install wshobson/agents && npx oneskill map ───────╮
│ │
│ ✔ Repository cloned │
│ Found 140 skill(s) │
│ │
│ ? Select skills to install: (Press <space> to select, <i> to invert) │
│ ❯ ◉ fastapi-templates │
│ ◯ architecture-patterns │
│ ◯ api-design-principles │
│ ↓ Scroll down for more... │
│ │
│ [Agent Action]: Selected 'fastapi-templates' and confirmed │
│ │
│ ✅ Installed: fastapi-templates │
│ │
│ [Auto-trigger mapping] │
│ ✔ Mapped 1 skills to Gemini CLI configuration. │
╰────────────────────────────────────────────────────────────────────────────╯
✦ Installation complete! I have learned `fastapi-templates`.
Now you can ask me: "How do I use this template to create a new project with async mode?"
💥 Result: The Agent automatically completed the search, download, filtering, and environment configuration without you having to type a single command.
📖 Command Reference (Generally, you should use natural language in AI tools; no manual execution required)
Don't know what to install? Let OneSkill help you find it.
npx oneskill search "web browser" # Search for web browsing related skills
npx oneskill search "database" --sort stars # Search for the most popular database skillsUse the standard OpenSkills command for downloads.
npx openskills install <repository-name>
# Example: npx openskills install anthropics/skills- Map (Important for Gemini/Qwen): If you are using Gemini CLI or Qwen Code CLI, you must map the installed skills to your configuration.
# Maps installed skills to Gemini's config npx oneskill map --target gemini # Or for Qwen Code CLI npx oneskill map --target qwen
npx openskill list