Skip to main content

​
Installation

To equip your AI agent with these skills, you must place them in a location where the agent can discover them.
1

Copy the skills directory

The industry standard location for agent skills is the .github/skills/ directory at the root of your workspace.Copy the .github/skills/ folder from the Awesome Android Agent Skills repository to your project’s root.
# Clone the repository
git clone https://github.com/yourusername/awesome-android-agent-skills.git

# Copy skills to your project
cp -r awesome-android-agent-skills/.github/skills my-android-project/.github/
2

Verify the structure

Ensure your project structure looks like this:
my-android-project/
├── .github/
│   └── skills/
│       ├── android-architecture/
│       │   └── SKILL.md
│       ├── compose-ui/
│       │   └── SKILL.md
│       ├── android-viewmodel/
│       │   └── SKILL.md
│       └── ... (other skills)
├── app/
└── ...
3

Restart your IDE or agent

Some extensions (like GitHub Copilot) may need a window reload to index the new skills.
# Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
# Type: "Reload Window"
4

Test the installation

Ask your AI assistant a question related to Android development:
"How should I structure the new User Profile feature?"
The agent should now reference the architecture patterns defined in the skills.

​
Environment-Specific Setup

Different AI assistants may look for skills in different locations.

​
GitHub Copilot & VS Code

GitHub Copilot automatically discovers skills in .github/skills/ when they are part of your workspace.
No additional configuration needed! Just copy the skills to .github/skills/ and reload your window.

​
Claude / Anthropic

Legacy or direct Claude usage often looks for .claude/skills/. You can copy or symlink .github/skills to .claude/skills. 
# Create a symlink
ln -s .github/skills .claude/skills

​
OpenCode

OpenCode supports .opencode/skill/ (note singular skill) and .claude/skills/. Global skills can be placed in ~/.config/opencode/skill/. 
# Project-level skills
cp -r .github/skills .opencode/skill

# Global skills (available across all projects)
cp -r .github/skills ~/.config/opencode/skill

​
Cursor

Cursor follows the same convention as VS Code and GitHub Copilot: 
# Copy to .github/skills/
cp -r awesome-android-agent-skills/.github/skills .github/

​
Creating Custom Skills

You can extend the repository with your own custom skills for team-specific patterns or company conventions.
1

Create a skill folder

Create a new folder in .github/skills/ with a descriptive name:
mkdir -p .github/skills/my-custom-skill
2

Add a SKILL.md file

Create a SKILL.md file with the required frontmatter:
---
name: my-custom-skill
description: Description of what this skill does and when to use it
---

# My Custom Skill

## Instructions

Provide detailed instructions for the AI agent here.

### 1. First Section
- Clear, actionable guidelines
- Code examples
- Best practices

### 2. Checklist
- [ ] Verification step 1
- [ ] Verification step 2
3

Test your custom skill

Ask your AI assistant to use the skill by mentioning its purpose:
"Apply my custom skill to refactor this code"
Custom skills are perfect for enforcing company-specific coding standards, architectural patterns, or integration guidelines.

​
Next Steps

Usage Guide

Learn how to use skills with different AI assistants

Skill Reference

Browse all available skills and their documentation

Build docs developers (and LLMs) love

Get started for freeTalk to us