Skip to content

github-ops

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

github-ops

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
references
references
 
 
README.md
README.md
 
 
SKILL.md
SKILL.md
 
 
package.json
package.json
 
 

README.md

GitHub EngOps Skill

High-fidelity GitHub integration for Paperclip AI agents. Focused on Governance, Hygiene, and Cross-Tool Alignment.

Capabilities

  • PR Triage: Identify stagnant Pull Requests and notify authors.
  • Review Auditing: Ensure PRs meet your organization's compliance and approval standards.
  • Source-to-Task Linking: Extract Jira keys from PRs to maintain the EngOps Triad.
  • Repo Auditing: Verify that repositories contain standard documentation and security files.

Setup

1. Create a GitHub Token

  1. Go to Settings > Developer settings > Personal access tokens.
  2. Select Tokens (classic) and click Generate new token.
  3. Select repo scopes.
  4. Copy the token.

2. Configure Credentials

Add these to your environment or .env file:

GITHUB_TOKEN=your_generated_token_here
GITHUB_OWNER=your-org-name

Installation for Paperclip AI

This skill is best installed as part of the EngOps Suite to maintain horizontal integration.

Method A: The Suite Submodule (Recommended)

Add the entire suite and symlink this skill:

git submodule add https://github.com/KhairulA/eng-ops-skills.git .agents/eng-ops
ln -s eng-ops/skills/github-ops .agents/github-ops

Method B: Single Skill Install

git submodule add https://github.com/KhairulA/eng-ops-skills.git .agents/github-ops

Common Workflows

The "Stale PR" Cleanup

"Identify all PRs in the 'web-app' repo that haven't been touched in 3 days. Post a comment asking if the author needs help and link to the 'PR Process' doc in Outline."

The "Triad Audit" (GitHub + Jira)

"Check PR #88. Extract the Jira key from the description, then use jira-ops to check if that ticket is in 'In Progress'. If it is 'Done', ask the developer why the PR is still open."

EngOps Horizontal Integration

This skill is built to the EngOps Standard and is fully compatible with our horizontal core:

  • PII Guard: Auto-redacts secrets and PII before processing.
  • Audit Logging: All write-actions generate a standard JSON audit trail.
  • Governance: Supports human-in-the-loop approval gates.

For detailed API definitions, see SKILL.md.