AGENT SKILL

repos

List the active GitHub account's public repositories as Markdown bullets with repository links and summaries capped at 500 characters. Use when the user invokes /repos or $repos, asks for a bulleted list of public GitHub repositories with summaries, or wants a one-shot summarized public repo inventory from the currently authenticated gh account or via connected GitHub MCP.

License 许可
MIT
最近更新
2026-07-19
Stars
★ 1
Forks
1

01 前言 Front Matter

name
repos
metadata
{ "source": "Codex skill 'repos' (ported 2026-05-24)", "short-description": "One-shot public GitHub repo inventory with README-derived summaries" }
description
List the active GitHub account's public repositories as Markdown bullets with repository links and summaries capped at 500 characters. Use when the user invokes /repos or $repos, asks for a bulleted list of public GitHub repositories with summaries, or wants a one-shot summarized public repo inventory from the currently authenticated gh account or via connected GitHub MCP.
when-to-use
User asks to list my public repos, show my GitHub repositories, inventory of public projects, or 'what repos do I have on GitHub'. Returns clean Markdown bullets with auto-generated summaries from description or README. Complements grok_com_github MCP list/search tools when richer summaries are needed.
allowed-tools
[ "run_terminal_cmd", "read_file", "web_search", "grok_com_github" ]
argument-hint
[--limit N] (defaults to all public repos via gh)

02 资源文件 1

03 SKILL.md 正文

Repos (Grok Port)

Purpose

Emit a clean, immediately usable Markdown list of the authenticated user's public GitHub repositories, each with a concise summary (≤500 chars) derived from the repository description or a cleaned extract of its README. This is the exact deliverable the original Codex skill produced.

Primary path (recommended for fidelity): Run the bundled helper script via run_terminal_cmd. It uses the gh CLI (must be installed and authenticated) and produces exactly the original output contract.

Alternative (when grok_com_github MCP is connected and preferred): Use the MCP tools (get_me, search_repositories or list equivalents) for basic inventory, but note that the script's README-derived summaries add unique value not always present in raw MCP responses.

Workflow

  1. Resolve authentication & scope

    • If grok_com_github MCP tools are connected and the user prefers native MCP: call the MCP schema discovery first (if names uncertain), then use get_me + repository listing/search tools. Document the source.
    • Otherwise (or for the signature summary behavior): invoke the helper script.
  2. Invoke the helper (primary)

    python3 "<SKILL_DIR>/scripts/list_public_repos.py"
    

    Where <SKILL_DIR> is the absolute path to this skill's directory after installation (e.g. ~/.grok/skills/repos or <repo>/.grok/skills/repos).

  3. Return the output verbatim

    • The script prints one Markdown bullet per public repo.
    • Return it directly to the user with no extra commentary unless the user asked for additional processing.
    • If the script fails (e.g. gh not found, not authenticated, network), report the exact error from stderr and stop. Do not fall back to web scraping, search, or invented repo lists.

The Bundled Script

Location: <SKILL_DIR>/scripts/list_public_repos.py

  • Pure Python + gh CLI (no pip dependencies).
  • Fetches public repos for the gh auth owner.
  • For each: uses repo description if present; otherwise fetches README via gh api, strips Markdown to first ~sentence window (≤500 chars).
  • Marks public forks with _(fork)_.
  • Repos with no usable summary text get exactly: No public description or README summary available.

Example invocation (Grok agent):

run_terminal_cmd with command is python3 "/Users/you/.grok/skills/repos/scripts/list_public_repos.py"

Example output contract (preserved exactly):

- [prime-gap-structure](https://github.com/velocityworks/prime-gap-structure): Deep deterministic structure in prime gaps via the Divisor Normalization Identity and Leftmost Minimum-Divisor Rule.
- [flaming-horse](https://github.com/velocityworks/flaming-horse): Deterministic Manim + Qwen + ffmpeg video generation pipeline _(fork)_
- [handrail](https://github.com/velocityworks/handrail): ... (or the fallback sentence)

Grok-Specific Adaptations & Integration

  • MCP preference: If the connected grok_com_github server exposes convenient listing tools and the user is in a pure-MCP workflow, you may use those for the basic list and then optionally enrich summaries by cloning or fetching READMEs via open_page / web_fetch + the same cleaning logic. However, for the canonical "one-shot summarized inventory" the script remains the gold path because it encapsulates the exact summary extraction.
  • Authentication: The script relies on gh being logged in (gh auth status). In environments where only the MCP is authenticated, fall back to MCP tools + note the limitation.
  • Rate limits / scale: The script requests up to 1000 public repos. For very large accounts, the user can pipe or post-process.
  • Composability: The Markdown output is designed to be pasted into issues, PRs, research notes, or fed into other skills (e.g. prompts-issue-deep-dive, research skills).

Success Criteria

  • The response is exactly (or clearly derived from) the script's Markdown bullet list.
  • Every listed repo has a link, a summary ≤500 chars, and fork marker when applicable.
  • No invented repositories or summaries.
  • Failures surface the real gh error.
  • User can immediately copy the list into GitHub, Notion, or another tool.

Stop Conditions

  • gh CLI missing or unauthenticated and no usable MCP github connection.
  • User explicitly asks for private repos, specific orgs, or filtered subsets (then use gh repo list variants or MCP search directly and report).

This port preserves the original's "return the script output directly" contract while making the helper self-documenting and natural to invoke from a Grok agent equipped with run_terminal_cmd.

04 同仓库更多 Skills

zfifteen
zfifteen/skills-catalog

Zotero

Use Zotero Desktop from Codex to enable/probe the local API, search a local Zotero library, list items/collections/tags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX/RIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.

★ 1
zfifteen
zfifteen/skills-catalog

zoom-apps-sdk

Use when using Apps SDK.

★ 1
zfifteen
zfifteen/skills-catalog

youtube

Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript. Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or "what does this video actually say". The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content. Triggers: "youtube transcript", "get the transcript of this video", "summarize this youtube video", "what did they say in https://youtube.com/...", "key claims from this talk".

★ 1
zfifteen
zfifteen/skills-catalog

yeet

Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.

★ 1
zfifteen
zfifteen/skills-catalog

x-post-creator

Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, /x-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs/x-posts/[story-name]/.

★ 1
zfifteen
zfifteen/skills-catalog

x-api

Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X/x.com, reading threads and replies, creating lists, staging/publishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions /x-api or "search X".

★ 1