@yigstudio/skill-github

GitHub integration skill for Yigstudio (MCP Server).

Features

Provides 4 GitHub tools:

• github.createIssue - Create GitHub issues
• github.listPRs - List pull requests
• github.searchCode - Search code in repositories
• github.getFileContent - Get file contents

Installation

npm install @yigstudio/skill-github

Usage

As MCP Server

Run as a standalone MCP server:

export GITHUB_TOKEN="your-github-token"
npx @yigstudio/skill-github

With Yigstudio

Register in your Yigstudio application:

import { MCPClientManager } from '@yigstudio/mcp-runtime';
import { SkillRegistry } from '@yigstudio/skills';

const mcpClient = new MCPClientManager();
const skillRegistry = new SkillRegistry();

// Register GitHub skill
await mcpClient.registerServer({
  id: 'skill-github',
  name: 'GitHub Skill',
  transport: {
    type: 'stdio',
    command: 'npx',
    args: ['@yigstudio/skill-github'],
    env: {
      GITHUB_TOKEN: process.env.GITHUB_TOKEN ?? '',
    },
  },
});

// Register skill metadata
skillRegistry.register({
  id: 'github-create-issue',
  name: 'Create GitHub Issue',
  description: 'Create a GitHub issue',
  version: '1.0.0',
  permissions: ['github:write'],
  mcpServer: {
    serverId: 'skill-github',
    command: 'npx',
    args: ['@yigstudio/skill-github'],
    env: {
      GITHUB_TOKEN: process.env.GITHUB_TOKEN ?? '',
    },
  },
});

Tools

github.createIssue

Create a new issue in a GitHub repository.

Parameters:

• owner (string, required): Repository owner
• repo (string, required): Repository name
• title (string, required): Issue title
• body (string, optional): Issue body (markdown)
• labels (string[], optional): Labels to add
• assignees (string[], optional): Assignees

Example:

{
  "owner": "Henghenggao",
  "repo": "Yigstudio",
  "title": "Add new feature",
  "body": "This is a feature request",
  "labels": ["enhancement"],
  "assignees": ["username"]
}

github.listPRs

List pull requests in a repository.

Parameters:

• owner (string, required): Repository owner
• repo (string, required): Repository name
• state (string, optional): PR state (open/closed/all, default: open)
• per_page (number, optional): Results per page (default: 30)
• page (number, optional): Page number (default: 1)

github.searchCode

Search code across GitHub repositories.

Parameters:

• query (string, required): Search query
• owner (string, optional): Repository owner filter
• repo (string, optional): Repository name filter
• per_page (number, optional): Results per page (default: 30)
• page (number, optional): Page number (default: 1)

Example:

{
  "query": "function initializeAgent",
  "owner": "Henghenggao",
  "repo": "Yigstudio"
}

github.getFileContent

Get the content of a file from a repository.

Parameters:

• owner (string, required): Repository owner
• repo (string, required): Repository name
• path (string, required): File path
• ref (string, optional): Branch/tag/commit SHA

Example:

{
  "owner": "Henghenggao",
  "repo": "Yigstudio",
  "path": "README.md",
  "ref": "main"
}

Environment Variables

• GITHUB_TOKEN (required): GitHub Personal Access Token

Permissions

• github:read: List PRs, search code, get file content
• github:write: Create issues

License

MIT