Skill Name\r

\r

Overview\r

\r A short description of what this skill does.\r \r Example:\r \r

This skill allows the agent to search GitHub repositories, fetch code snippets, and summarize project structures.\r \r ---\r \r

Metadata\r

\r

name: github-integration\r
version: 1.0.0\r
category: developer-tools\r
description: GitHub integration skill for repositories and code analysis\r
author: Your Name\r
license: MIT\r
```\r
\r
---\r
\r
# Purpose\r
\r
Explain:\r
\r
* Why this skill exists\r
* What problem it solves\r
* Which workflows it supports\r
\r
Example:\r
\r
* Repository analysis\r
* Pull request summaries\r
* File search\r
* Commit history lookup\r
\r
---\r
\r
# Capabilities\r
\r
List the major capabilities of the skill.\r
\r
## Features\r
\r
* Search repositories\r
* Read repository files\r
* Fetch pull requests\r
* Analyze commits\r
* Generate summaries\r
* Semantic search support\r
\r
---\r
\r
# Inputs\r
\r
Describe what input the skill expects.\r
\r
| Input Name | Type   | Required | Description            |\r
| ---------- | ------ | -------- | ---------------------- |\r
| repository | string | Yes      | GitHub repository name |\r
| branch     | string | No       | Branch name            |\r
| query      | string | No       | Search query           |\r
\r
---\r
\r
# Outputs\r
\r
Describe the response structure.\r
\r
| Field   | Type   | Description        |\r
| ------- | ------ | ------------------ |\r
| summary | string | Generated summary  |\r
| files   | array  | Matching files     |\r
| commits | array  | Commit information |\r
\r
---\r
\r
# Environment Variables\r
\r
```env\r
GITHUB_TOKEN=your_token_here\r
API_BASE_URL=https://api.github.com\r
```\r
\r
---\r
\r
# Installation\r
\r
## Clone Repository\r
\r
```bash\r
git clone https://github.com/example/skill.git\r
cd skill\r
```\r
\r
## Install Dependencies\r
\r
```bash\r
npm install\r
```\r
\r
---\r
\r
# Usage\r
\r
## Example Request\r
\r
```json\r
{\r
  "repository": "openai/openai-python",\r
  "query": "embedding implementation"\r
}\r
```\r
\r
## Example Response\r
\r
```json\r
{\r
  "summary": "Found embedding-related files and utilities.",\r
  "files": [\r
    "embeddings.py",\r
    "vector_store.py"\r
  ]\r
}\r
```\r
\r
---\r
\r
# Architecture\r
\r
Explain how the skill works internally.\r
\r
Example Flow:\r
\r
```text\r
User Request\r
    ↓\r
Skill Router\r
    ↓\r
Authentication Layer\r
    ↓\r
GitHub API Client\r
    ↓\r
Processing Layer\r
    ↓\r
Formatted Response\r
```\r
\r
---\r
\r
# Error Handling\r
\r
Common errors and solutions.\r
\r
| Error                | Cause             | Solution          |\r
| -------------------- | ----------------- | ----------------- |\r
| Unauthorized         | Invalid token     | Update API token  |\r
| Rate Limited         | Too many requests | Retry later       |\r
| Repository Not Found | Wrong repo name   | Verify repository |\r
\r
---\r
\r
# Security\r
\r
Describe security considerations.\r
\r
* Store tokens securely\r
* Never expose secrets in logs\r
* Use HTTPS requests only\r
* Apply permission checks\r
\r
---\r
\r
# Best Practices\r
\r
* Cache frequent API responses\r
* Use pagination for large repositories\r
* Validate user inputs\r
* Handle API rate limits\r
\r
---\r
\r
# Dependencies\r
\r
```json\r
{\r
  "axios": "^1.0.0",\r
  "dotenv": "^16.0.0"\r
}\r
```\r
\r
---\r
\r
# Future Improvements\r
\r
* Add vector search\r
* Add webhook support\r
* Add multi-repository analysis\r
* Improve semantic ranking\r
\r
---\r
\r
# Maintainers\r
\r
| Name      | Role      |\r
| --------- | --------- |\r
| Your Name | Developer |\r
\r
---\r
\r
# License\r
\r
MIT License\r