AI Agent Skills

A collection of portable skills for AI coding assistants. Works with all major AI clients that support the Agent Skills Standard.

Supported AI Clients

| Client | Skills Directory | Documentation | |--------|-----------------|---------------| | Claude Code | ~/.claude/skills/ or .claude/skills/ | docs | | Gemini CLI | ~/.gemini/skills/ or .gemini/skills/ | docs | | Google Antigravity | ~/.gemini/antigravity/skills/ or .agent/skills/ | docs | | Cursor | ~/.cursor/skills/ or .cursor/skills/ | docs | | OpenAI Codex CLI | ~/.codex/skills/ or .codex/skills/ | docs | | Goose | ~/.config/goose/skills/ or .goose/skills/ | docs |

Available Skills

| Skill | Description | |-------|-------------| | postgres | Read-only PostgreSQL queries with defense-in-depth security | | imagen | AI image generation using Google Gemini (cross-platform) | | deep-research | Autonomous multi-step research using Gemini Deep Research Agent | | outline | Search, read, and manage Outline wiki documents | | jules | Delegate coding tasks to Google Jules AI agent (async bug fixes, docs, tests, features) |

Google Workspace Skills

Lightweight alternatives to the full Google Workspace MCP server. Each skill has standalone OAuth authentication with cross-platform token storage via keyring.

⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported. These skills use the same OAuth infrastructure as the official Google Workspace MCP.

| Skill | Description | |-------|-------------| | google-chat | List spaces, send messages, DMs, create spaces | | google-docs | Create, read, edit Google Docs | | google-sheets | Read spreadsheets, get ranges, find sheets | | google-slides | Read presentations, get text and metadata | | google-drive | Search files, list folders, download files | | google-calendar | Events, scheduling, free time lookup | | gmail | Search, read, send emails, manage labels |

Installation

Option 1: Clone entire repository

# Clone to your preferred skills directory
git clone https://github.com/sanjay3290/ai-skills.git ~/.claude/skills/ai-skills

# Or for other clients:
# git clone https://github.com/sanjay3290/ai-skills.git ~/.gemini/skills/ai-skills
# git clone https://github.com/sanjay3290/ai-skills.git ~/.gemini/antigravity/skills/ai-skills
# git clone https://github.com/sanjay3290/ai-skills.git ~/.cursor/skills/ai-skills
# git clone https://github.com/sanjay3290/ai-skills.git ~/.codex/skills/ai-skills
# git clone https://github.com/sanjay3290/ai-skills.git ~/.config/goose/skills/ai-skills

Option 2: Copy individual skills

# Example: Install just the postgres skill
cp -r skills/postgres ~/.claude/skills/

Option 3: Symlink for development

# Symlink skills for easy updates
ln -s /path/to/ai-skills/skills/postgres ~/.claude/skills/postgres
ln -s /path/to/ai-skills/skills/imagen ~/.claude/skills/imagen

Client-Specific Installation

Claude Code

# Global installation
cp -r skills/* ~/.claude/skills/

# Or project-level
cp -r skills/* .claude/skills/

Gemini CLI

# Global installation
cp -r skills/* ~/.gemini/skills/

# Or workspace-level
cp -r skills/* .gemini/skills/

Google Antigravity

# Global installation
cp -r skills/* ~/.gemini/antigravity/skills/

# Or workspace-level
cp -r skills/* .agent/skills/

Cursor

# Global installation
cp -r skills/* ~/.cursor/skills/

# Or project-level
cp -r skills/* .cursor/skills/

OpenAI Codex CLI

# Global installation
cp -r skills/* ~/.codex/skills/

# Or repository-level
cp -r skills/* .codex/skills/

Goose

# Global installation
cp -r skills/* ~/.config/goose/skills/

# Or project-level
cp -r skills/* .goose/skills/

Skill Setup

Each skill may require additional configuration:

Postgres

Create connections.json in the skill directory with your database credentials. See postgres/README.md.

Imagen & Deep Research

export GEMINI_API_KEY=your-api-key

Get a free key at Google AI Studio.

Note: Deep Research tasks take 2-10 minutes and cost $2-5 per query.

Outline

export OUTLINE_API_KEY=your-api-key
export OUTLINE_API_URL=https://your-wiki.example.com/api  # Optional

Get your API key from your Outline wiki settings.

Jules

# Install CLI (one-time)
npm install -g @google/jules

# Authenticate (opens browser)
jules login

Connect your GitHub repos at jules.google.com. Jules works asynchronously - create a task, it runs in the background, then pull results when complete.

Google Workspace Skills

Each Google Workspace skill requires the keyring library and first-time authentication:

# Install dependency (one-time)
pip install keyring

# Authenticate for the skill you need (opens browser)
python ~/.claude/skills/ai-skills/skills/google-chat/scripts/auth.py login
python ~/.claude/skills/ai-skills/skills/google-docs/scripts/auth.py login
python ~/.claude/skills/ai-skills/skills/google-sheets/scripts/auth.py login
python ~/.claude/skills/ai-skills/skills/google-slides/scripts/auth.py login
python ~/.claude/skills/ai-skills/skills/google-drive/scripts/auth.py login
python ~/.claude/skills/ai-skills/skills/google-calendar/scripts/auth.py login
python ~/.claude/skills/ai-skills/skills/gmail/scripts/auth.py login

Tokens stored securely via system keyring:

• macOS: Keychain
• Windows: Windows Credential Locker
• Linux: Secret Service API (GNOME Keyring, KDE Wallet, etc.)

Usage

Once installed, skills activate automatically based on your requests. Just ask naturally:

Postgres

• "Query my production database for active users"
• "Show me the schema of the orders table"
• "How many signups last week?"

Imagen

• "Generate an image of a sunset over mountains"
• "Create an app icon for my weather app"
• "I need a hero image for my landing page"

Deep Research

• "Research the competitive landscape of EV batteries"
• "Compare React, Vue, and Angular frameworks"
• "What are the latest developments in Kubernetes?"

Outline

• "Search the wiki for deployment guide"
• "Read the onboarding documentation"
• "Create a new wiki page for the API spec"

Jules

• "Have Jules fix the authentication bug in src/auth.js"
• "Delegate adding unit tests to Jules"
• "Ask Jules to add documentation to the API module"
• "Check my Jules sessions" / "Pull the results from Jules"

Google Workspace

• "List my Google Chat spaces" / "Send a message to Project Alpha"
• "Create a new Google Doc about the project proposal"
• "Get the content of my Q4 Budget spreadsheet"
• "What's on my calendar tomorrow?"
• "Search my Gmail for invoices from last month"
• "Find files named 'report' in my Drive"

Skill Structure

All skills follow the Agent Skills Standard:

skill-name/
├── SKILL.md              # Required: Instructions for the AI agent
├── README.md             # Human documentation
├── requirements.txt      # Dependencies (if any)
├── .env.example          # Environment variable template
└── scripts/              # Executable scripts
    └── main.py

The SKILL.md file uses YAML frontmatter:

---
name: skill-name
description: "When to use this skill"
---

# Instructions for the AI agent

Contributing

1. Fork this repository
2. Create a new skill in skills/your-skill-name/
3. Include SKILL.md with proper frontmatter
4. Add documentation in README.md
5. Submit a pull request

Credits

• Google Workspace Skills - Based on the official Google Workspace MCP server by the Gemini CLI team. Uses their OAuth cloud function for authentication.

License

Apache-2.0