Gemini Skills

A collection of skills for the Gemini CLI that enhance its capabilities with features like README generation, .gitignore creation, and GitHub integration.

📖 Table of Contents

• Features
• Prerequisites
• Installation
• Usage
• Project Structure
• Contributing
• License

---

✨ Features

• readme-master: Generates a professional README.md for your project by scanning its files, dependencies, and Git metadata.
• gitignore-generator: Creates a .gitignore file tailored to your project's tech stack and existing directories.
• github-pilot-v2: A GitHub assistant that can commit, push, analyze commit history, and manage repositories. Uses the GitHub MCP server.

⚠️ Prerequisites

• Python 3.6+
• Gemini CLI – the AI‑powered terminal assistant
• For github-pilot only:
  • Docker (must be running) or use the --remote flag to use a hosted MCP server.
  • A GitHub Personal Access Token with repo and read:user scopes.

🚀 Installation

Each skill is installed separately. All install scripts support the --scope workspace flag to install the skill in the current project only (instead of globally).

Note: The repository uses a double-nested directory structure (e.g. readme-master/readme-master/). The outer folder is the repository root; the inner folder is the actual skill package. Always cd into the inner directory before running the install script.

readme-master

# 1. Navigate to the inner skill directory
cd readme-master/readme-master

# 2. Install globally (default)
bash install.sh

# Or install only for the current workspace:
bash install.sh --scope workspace

After installation, restart the Gemini CLI:

/skills reload
/skills list    # confirm "readme-master" appears

gitignore-generator

# 1. Navigate to the skill directory
cd gitignore-generator

# 2. Install globally
bash install.sh

# Or workspace only:
bash install.sh --scope workspace

After installation, restart the Gemini CLI:

/skills reload
/skills list    # confirm "gitignore-generator" appears

github-pilot-v2

# 1. Navigate to the inner skill directory
cd github-pilot-v2/github-pilot-v2

# 2. Install with interactive PAT prompt (recommended)
bash setup.sh

# Or supply your PAT directly (non‑interactive):
bash setup.sh --token ghp_yourtoken

# Use hosted MCP instead of Docker:
bash setup.sh --remote

# Install only for the current workspace:
bash setup.sh --scope workspace

After installation:

1. Restart the Gemini CLI:

   /skills reload
   /skills list    # confirm "github-pilot" appears
   /mcp            # verify "github" is connected

2. Your GitHub token is stored securely in ~/.gemini/.env.

💻 Usage

All skills are activated by typing natural‑language prompts inside the Gemini CLI – not as shell commands. Just type the trigger phrase.

readme-master

Generate a README for this project

The skill will scan your project, gather context (dependencies, entry points, Git metadata), and produce a detailed README.md.

gitignore-generator

Create a .gitignore file for this project

It detects your tech stack and existing directories, then generates a tailored .gitignore (preserving any custom rules if a file already exists).

github-pilot-v2

Push my changes with a good commit message
Analyze my commits
Save my commit history

• Commit & push: The skill will craft a conventional commit message and ask for confirmation before pushing.
• Commit analysis: It collects commits across all your repos and generates a detailed report.
• Export history: Saves raw commit data as JSON.

All exported data and analysis reports are saved to ~/Documents/commits/:

• <repo-name>_<date>.json – raw commits per repository
• analysis_<date>.md – human‑readable analysis report
• analysis_<date>.json – structured data for further processing

📁 Project Structure

Gemini-Skills/
├── github-pilot-v2/
│   └── github-pilot-v2/           # installable skill package
│       ├── scripts/
│       │   └── analyze_commits.py # Standalone analyzer: reads JSON exports,
│       │                           # produces markdown + JSON report
│       ├── MCP_REFERENCE.md        # MCP tool reference loaded at skill activation
│       ├── SKILL.md                # Skill definition and flow logic
│       └── setup.sh                # Installer (supports --token, --remote, --scope)
├── gitignore-generator/
│   ├── scripts/
│   │   └── gather_context.py       # Scans project for tech stack & directories
│   ├── SKILL.md                    # Skill definition
│   └── install.sh                  # Installer (supports --scope)
└── readme-master/
    └── readme-master/              # installable skill package
        ├── scripts/
        │   └── gather_context.py   # Scans files, dependencies, Git metadata
        ├── SKILL.md                # Skill definition and template
        ├── TEMPLATE_REFERENCE.md   # Structural reference for README generation
        └── install.sh              # Installer (supports --scope)

Note: The double nesting (e.g. readme-master/readme-master/) allows the repository to contain the skill’s source files while keeping the installable package separate. Always cd into the inner folder before running the install script.

🤝 Contributing

Contributions are welcome! Please feel free to submit a pull request.

# Fork and clone
git checkout -b feature/your-feature

# Make your changes

# Submit a PR

📜 License

MIT — see LICENSE for details.