ingest-github

Pull and normalize GitHub PRs, issues, and commits into markdown files.

31|20|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-github
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ingest-github
Source: https://github.com/mycelium-hq/ai-brain-starter/tree/main/skills/ingest-github
Command: npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-github

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ingests recent GitHub repository activity into the vault as markdown the graphify pipeline can read and the rest of the AI Brain Starter substrate (decision log, session-close cascade, hooks) can act on.

Core Features & Use Cases

  • Ingests merged PRs, issues, and commits from a repository into the vault as structured markdown for querying.
  • Writes one file per repo per day to External Inputs/GitHub/<owner-repo>/<YYYY-MM-DD>.md and supports idempotent re-runs.
  • Provides a deterministic workflow that can be invoked on demand or as part of automated knowledge ingestion.

Quick Start

Invoke /ingest-github <owner/repo> [--days N] to ingest recent PRs, issues, and commits into the vault and store them at External Inputs/GitHub/<owner-repo>/<YYYY-MM-DD>.md.

Frequently Asked Questions about ingest-github

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ingest GitHub pull requests and commits into a markdown vault?

To ingest GitHub activity into a markdown vault, you can pull and normalize recent pull requests, issues, and commits from a repository into a structured markdown file with generated frontmatter. The output is written to External Inputs/GitHub/<owner-repo>/<YYYY-MM-DD>.md.

How do I synchronize GitHub repository activity for a specific date range?

To synchronize GitHub repository activity for a specific date range, invoke the ingestion command with the optional days parameter to fetch merged PRs, issues, and commits within that window. The process generates frontmatter including repo, date_range, item_count, ingested_at, and entity_ids.

Can I re-run GitHub activity ingestion without creating duplicate vault files?

Yes, you can re-run GitHub activity ingestion without creating duplicate vault files because the process supports idempotent re-runs. It writes one deterministic markdown file per repository per day, ensuring repeated synchronization operations overwrite rather than duplicate the output.

Does this GitHub ingestion method require the GitHub MCP to fetch issues?

Yes, this GitHub ingestion method requires the GitHub MCP to fetch merged pull requests, issues, and commits. It relies on this protocol layer to pull the raw repository activity data before normalizing it into vault-friendly markdown.

What is the best way to store GitHub commits as structured markdown for querying?

The best way to store GitHub commits as structured markdown for querying is to ingest them into your vault with standardized frontmatter. This approach writes normalized activity data to dated files that the graphify pipeline and other substrate components can read and act on.

When should I not use automated GitHub activity ingestion?

You should not use automated GitHub activity ingestion when you need real-time event streaming rather than daily batch synchronization, as the process writes one file per repository per day. It is designed for on-demand or scheduled knowledge ingestion, not continuous polling.