ai-skills

By artium-projects.com

Portable AI skills, prompts, and MCP server configs that aim to support as many tools as possible. The structure makes it easy to save, transfer, and use your AI tools in any new environment.

Fork or clone this repo as a starting point for your own setup. Add your own skills, customize the prompts, and use the install script to deploy them to any machine or project.

---

About

Managing AI tool configurations across multiple machines and projects is tedious. Each tool (Claude Code, Gemini CLI, GitHub Copilot) has its own config location and format. This repo provides a template structure that centralizes all skills, prompts, agents, hooks, plugins, and MCP configs in one place with a simple install script to deploy them wherever needed. The included skills are examples — the goal is for you to build your own collection.

---

Architecture

┌──────────────┐       install.sh        ┌──────────────────┐
│              │ ──────────────────────▶  │  ~/.claude/       │
│              │       ./install.sh       │    skills/        │
│   ai-skills  │       claude <component> │    agents/        │
│   repo       │                          │    hooks/         │
│              │                          │    plugins/       │
│  skills/     │       install.sh         └──────────────────┘
│  agents/     │ ──────────────────────▶  ┌──────────────────┐
│  hooks/      │       ./install.sh       │  ~/.gemini/       │
│  plugins/    │       gemini <component> │    skills/        │
│  mcp/        │                          │    agents/        │
│  prompts/    │                          └──────────────────┘
│              │       install.sh         ┌──────────────────┐
│              │ ──────────────────────▶  │  ~/.github/       │
│              │       ./install.sh       │    copilot-       │
│              │       copilot <component>│    instructions.md│
└──────────────┘                          └──────────────────┘

---

Tech Stack

Category	Tools
Scripting	Bash
AI Tools	Claude Code, Gemini CLI, GitHub Copilot

---

Getting Started

Prerequisites

• Git
• Bash (Git Bash on Windows, or any Unix shell)

Setup

Clone the repo and use the install script, or manually copy the files you need.

git clone <repo-url> ~/ai-skills
cd ~/ai-skills

Install a specific component to a specific tool:

./install.sh claude skills
./install.sh claude agents
./install.sh claude hooks
./install.sh claude plugins
./install.sh gemini skills
./install.sh copilot skills

Safe by default: The install script never overwrites existing files. If a skill or config already exists at the target, it is skipped. Use --dry-run to preview what would happen, and --force only when you want to overwrite.

Install into a specific project:

./install.sh claude skills project /path/to/project

Preview what would be copied:

./install.sh claude skills --dry-run

Overwrite existing files:

./install.sh claude skills --force

See all options:

./install.sh --help

---

Project Structure

ai-skills/
├── skills/              # Universal skills (shared across all tools)
│   ├── commit-msg/
│   └── review/
├── agents/              # Tool-specific agent definitions
│   ├── claude/
│   └── gemini/
├── hooks/               # Tool-specific hook configurations
├── plugins/             # Claude Code plugins
├── mcp/                 # MCP server configurations
├── prompts/             # Prompt templates per tool
│   ├── CLAUDE.md
│   ├── GEMINI.md
│   └── copilot-instructions.md
└── install.sh

Directory	Scope	Purpose
skills/	Universal	Reusable skills that work with any AI tool
agents/	Per tool	Agent definitions (subfolder per tool)
hooks/	Per tool	Hook configurations (subfolder per tool)
plugins/	Claude	Claude Code plugin packages
mcp/	Universal	MCP server configurations
prompts/	Per tool	Instruction templates (CLAUDE.md, GEMINI.md, etc.)

---

Key Design Decisions

• Why copy instead of symlinks? — Symlinks on Windows require admin privileges or Developer Mode. Copying is simple, portable, and works everywhere.
• Why universal skills? — Skills, prompts, and MCP configs are largely tool-agnostic. Only agents need tool-specific formats, so they get subfolders per tool.
• Why require a component? — Installing everything at once risks deploying components you didn't intend to. Explicit is safer.

---

Adding a New Skill

1. Create a folder under skills/:

   skills/my-skill/
   └── SKILL.md
   

2. Write the skill with frontmatter and instructions in SKILL.md.

3. Re-run the install script to deploy, e.g. ./install.sh claude skills or ./install.sh gemini skills.

---

Updating

cd ~/ai-skills
git pull
./install.sh claude skills --force
./install.sh claude agents --force

---

Sharing

Team members clone the repo and run the install script for each component and tool they use:

./install.sh claude skills
./install.sh claude agents
./install.sh gemini skills

---

License

This project is licensed under the MIT License.