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