Skills Repository

Overview

This repository contains a collection of skills — modular, self-contained packages that extend AI agent capabilities (Claude Code, Gemini CLI, CodeBuddy, etc.) with specialized workflows, domain knowledge, and reusable tools.

Repository Structure

skills/
├── README.md                  # This file
├── Makefile                   # Build & install automation
├── flake.nix                  # Nix dev environment (optional)
├── <skill-name>/              # One directory per skill
│   ├── SKILL.md               # Required: metadata + instructions
│   ├── scripts/               # Optional: Python/Bash scripts
│   ├── references/            # Optional: domain documentation
│   └── assets/                # Optional: templates, images, fonts
└── <skill-name>.zip           # Distributable package (generated)

Available Skills

Skill	Description
build-android	Compile, build, and run Gradle tasks for Android projects
code-quality-review	Unified code review across all languages
find-java	Locate all Java installations on the system
jadx	Decompile and reverse-engineer Android/Java binaries
python-dev	Python development workflow (lint, venv, type check)
run-agent	Run Claude sub-agents for complex tasks
skill-creator	Guide for creating new skills
whypua	Systematic debugging and root-cause analysis

---

Installation

Prerequisites

• make (standard on macOS/Linux; on Windows use WSL or Git Bash)
• zip command-line tool

Install to Claude Code

make install-claude

Copies all skill directories to ~/.claude/skills/ and sets correct file permissions (files: 644, dirs: 755).

Install to Gemini CLI

make install-gemini

Copies all skill directories to ~/.gemini/skills/.

Install to CodeBuddy

make install-codebuddy

Copies all skill directories to ~/.codebuddy/skills/.

Manual Install (single skill)

To install only one skill, copy its directory to the agent's skills folder:

# Example: install only the python-dev skill for Claude Code
cp -R python-dev ~/.claude/skills/
chmod -R 644 ~/.claude/skills/python-dev
find ~/.claude/skills/python-dev -type d -exec chmod 755 {} +

---

Packaging Skills (for distribution)

To generate .zip packages for all skills:

make all

To package a single skill:

cd skill-creator
python scripts/package_skill.py ../python-dev

The packaging script:

1. Validates SKILL.md frontmatter and structure
2. Creates a .zip named after the skill (e.g., python-dev.zip)

---

Creating a New Skill

Use the skill-creator skill or follow these steps manually:

Step 1 — Initialize

python skill-creator/scripts/init_skill.py <skill-name> --path .

This creates <skill-name>/SKILL.md with a template.

Step 2 — Edit SKILL.md

Every SKILL.md requires YAML frontmatter at the top:

---
name: my-skill
description: One sentence explaining what this skill does and when to use it.
---

Write instructions in imperative form (verb-first). Target audience is another AI agent instance.

Step 3 — Add Resources (optional)

Folder	Purpose	Example
scripts/	Deterministic Python scripts	rotate_pdf.py
references/	Domain docs loaded on demand	schema.md, api_docs.md
assets/	Output files (templates, images)	logo.png, template.html

Use only Python standard library; maintain Python 3.9+ compatibility.

Step 4 — Package

python skill-creator/scripts/package_skill.py ./<skill-name>

---

Development Environment (Nix, optional)

A flake.nix is provided with Python linters pre-installed:

nix develop
# Activates: flake8, pyright, ruff, shellcheck

---

Makefile Targets

Target	Description
make all	Package all skill directories into .zip files
make install-claude	Install all skills to ~/.claude/skills/
make install-gemini	Install all skills to ~/.gemini/skills/
make install-codebuddy	Install all skills to ~/.codebuddy/skills/
make clean	Remove all generated .zip files

---

How Skills Are Loaded by the Agent

Skills use a three-level progressive disclosure system:

1. Metadata (name + description in frontmatter) — always in context (~100 words)
2. SKILL.md body — loaded when the skill triggers (keep under 5 000 words)
3. Bundled resources (scripts/, references/, assets/) — loaded by the agent only as needed

This design keeps context lean while making full detail available on demand.

---

Quick Validation

To validate a skill without packaging:

python skill-creator/scripts/quick_validate.py ./<skill-name>