universal-skills

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #go #golang #machine-learning #rust #linux #docker #windows #kubernetes #security #openai #open-source

universal-skills

(★ 181)

No description available.

파일 탐색기

최종 버전 다운로드 (.zip)

- - publish.yml
- - constitution.md
- - agent-file-template.md
  - checklist-template.md
  - plan-template.md
  - spec-template.md
  - tasks-template.md
- creating-a-skill.md
- FAQ.md
- - data-model.md
  - plan.md
  - quickstart.md
  - research.md
  - spec.md
  - tasks.md
- - data-model.md
  - plan.md
  - quickstart.md
  - research.md
  - spec.md
  - tasks.md
- - install.ts
  - mcp.ts
- cli.ts
- constants.ts
- index.ts
- schemas.ts
- skill-loader.ts
- skill-scanner.ts
- types.ts
- utils.ts
.eslintrc.json
.gitignore
CHANGELOG.md
LICENSE.txt
package-lock.json
package.json
README.md
tsconfig.json

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

NOTE: Most agents support some form of skills by now so you may as well use the native implementations.

# Universal Skills

[![npm version](https://img.shields.io/npm/v/universal-skills.svg)](https://www.npmjs.com/package/universal-skills)
[![npm downloads](https://img.shields.io/npm/dt/universal-skills.svg)](https://www.npmjs.com/package/universal-skills)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Universal Skills** brings Anthropic's Skills feature to any AI coding agent that supports MCP. Skills are markdown files containing specialized knowledge that can be dynamically loaded into your agent's context only when needed.

### How to Use Skills

For a real-world example on how I personally use skills see [Creating a Skill](./docs/creating-a-skill.md).

### Why I built this

A week ago, I reverse engineered Claude Code's skills. A day ago, I spotted this repo [openskills](https://github.com/numman-ali/openskills) which implements skills for other coding agents. Their approach works but is suboptimal. That's why I decided to build a functional equivalent to Claude Code's skills based on MCP. See [why not use openskills](./docs/FAQ.md#why-dont-i-just-use-openskills) for details.

## Installation

<details>
<summary>Codex</summary>

Add the skills server to Codex using the MCP add command:

```bash
codex mcp add skills -- npx universal-skills mcp
```

</details>

<details>
<summary>Claude Code</summary>

Add the skills server to Claude Code using the MCP add command:

```bash
claude mcp add --transport stdio skills -- npx universal-skills mcp
```

</details>

<details>
<summary>OpenCode</summary>

Add the skills server to your OpenCode configuration by creating or editing the `opencode.json` file in your project root:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "skills": {
      "type": "local",
      "command": ["npx", "universal-skills", "mcp"],
      "enabled": true
    }
  }
}
```

For opencode I had to be quite explicit in instructing the agent to load a skill. I will have a look into their default instructions to improve that.

</details>

<details>
<summary>Other Agents</summary>

This should also work fine with Cursor and other Agent's that support MCP. Just not tested yet.

</details>

## Updating

To update to the latest version:

```bash
# Clear npx cache
npx clear-npx-cache

# Or manually remove cache
rm -rf ~/.npm/_npx-cache

# Reinstall with @latest tag
codex mcp remove skills
codex mcp add skills -- npx universal-skills@latest mcp
```

## Skill Directory Structure

Skills are automatically discovered from four directories in priority order (first match wins):

1. `yourproject/.agent/skills/` - Project-specific skills
2. `yourproject/.claude/skills/` - Project-specific skills
3. `~/.agent/skills/` - Global skills
4. `~/.claude/skills/` - Global skills

Each skill is a directory containing a `SKILL.md` file:

```
.agent/skills/
├── git/
│   └── SKILL.md
└── postgres/
    └── SKILL.md
```

**Priority Resolution**: If the same skill name exists in multiple directories, the one from the higher priority directory wins. This allows you to:
- Override global skills with project-specific versions
- Override Claude-specific skills with universal agent skills (useful when different agents need different configurations)

### Custom Skill Directories

Add additional directories to recursively search for skills using `--skill-dir` (can be specified multiple times). E.g. include skills installed via the Claude Code marketplace as follows. However, you can also install skills using `npx universal-skills install`. No benefit in using the Claude Code marketplace.

```bash
codex mcp add skills -- npx universal-skills mcp --skill-dir ~/.claude/plugins
```

## Download and install specific skills

Install a skill from a GitHub repository:

```bash
# Interactive mode (prompts for all options)
npx universal-skills install

# With all options
npx universal-skills install --repo https://github.com/user/repo --repo-dir skills/my-skill --local-dir ~/.claude/skills
```

## FAQ

For frequently asked questions, see the [FAQ documentation](./docs/FAQ.md).

## Troubleshooting

You can run `npx universal-skills mcp` in the folder of your project. It will print out which directories were searched for skills and which skills were picked up.

universal-skills

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

universal-skills

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README