Goosetown Researcher GitHub
aaif-goose/goosetown
Search GitHub issues, PRs, code, and discussions using the gh CLI.
Read, create, find, and cite Octo summaries through octo-cli.
Install Octo Summary
$ npx skills add Mininglamp-OSS/octo-cli --skill octo-summary -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Mininglamp-OSS/octo-cli octo-summary --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/octo-summary .claude/skills/octo-summary && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "octo-summary" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-summary into .claude/skills/octo-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-summary", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-summaryType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Mininglamp-OSS/octo-cli --skill octo-summary -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Mininglamp-OSS/octo-cli octo-summary --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/octo-summary .agents/skills/octo-summary && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "octo-summary" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-summary into .agents/skills/octo-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-summary", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Mininglamp-OSS/octo-cli --skill octo-summary -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Mininglamp-OSS/octo-cli octo-summary --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/octo-summary .cursor/skills/octo-summary && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "octo-summary" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-summary into .cursor/skills/octo-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-summary", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Mininglamp-OSS/octo-cli.git --path skills/octo-summary--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Mininglamp-OSS/octo-cli --skill octo-summary -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Mininglamp-OSS/octo-cli octo-summary --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/octo-summary .gemini/skills/octo-summary && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "octo-summary" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-summary into .gemini/skills/octo-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-summary", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Mininglamp-OSS/octo-cli octo-summaryInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Mininglamp-OSS/octo-cli --skill octo-summary -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/octo-summary .github/skills/octo-summary && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "octo-summary" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-summary into .github/skills/octo-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-summary", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Mininglamp-OSS/octo-cli --skill octo-summary -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Mininglamp-OSS/octo-cli octo-summary --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/octo-summary .opencode/skills/octo-summary && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "octo-summary" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-summary into .opencode/skills/octo-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-summary", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
octo-summary- GitHub stars
- 918
- Token cost
- ~1k tokens
- SKILL.md length
- 478 words
- Files
- 1
- Skills in repo
- 11
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Read, create, find, and cite Octo summaries through octo-cli.
- Works in 4 steps: Identify the summary by title and task_id. → Attribute claims to the returned… → Preserve the summary's citation marker… → …
- An agent needs to create an owner-only summary from explicit channels
- SKILL.md covers Authentication and scope, Create a summary, Discover summaries and Read and cite
- Needs OCTO_BOT_TOKEN
What it does
Octo Summary is an agent skill from Mininglamp-OSS/octo-cli. Read, create, find, and cite Octo summaries through octo-cli. Use when an agent needs to create an owner-only summary from explicit channels, discover summaries visible to its bot owner, inspect one summary, retrieve its current body, or ground an answer in returned citation metadata. Load after octo-shared.
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Backend & APIs, covering Citation management. The repository describes itself as: Metadata-driven CLI for AI Agent Bots — 48 operations across 7 domains, structured JSON envelope I/O, zero interactive prompts. The licence is Apache-2.0.
When your agent uses it
- An agent needs to create an owner-only summary from explicit channels
- Discover summaries visible to its bot owner
- Inspect one summary
- Retrieve its current body
Example prompts
- “/octo-summary”
Requirements
- A credential in OCTO_BOT_TOKEN
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Identify the summary by title and task_id.
- Attribute claims to the returned citation entry using its index, sender, sent time, source, and message sequence.
- Preserve the summary's citation marker such as [1] or [P1] when useful.
- Never invent missing surrounding conversation. Bot responses intentionally omit context_before and context_after.
What it can do on your machine
Read from SKILL.md and the folder at commit 6d21f11. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
OCTO_BOT_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Octo Summary loads about 1k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 478 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from Mininglamp-OSS/octo-cli at commit 6d21f11, republished under its Apache-2.0 licence (© Mininglamp-OSS). 478 words, ~1,045 tokens.
Download SKILL.mdSave it as
.claude/skills/octo-summary/SKILL.md (or your agent's skills folder).- name
- octo-summary
- description
- Read, create, find, and cite Octo summaries through octo-cli. Use when an agent needs to create an owner-only summary from explicit channels, discover summaries visible to its bot owner, inspect one summary, retrieve its current body, or ground an answer in returned citation metadata. Load after octo-shared.
- disabled
- true
Octo Summary
This skill can read summaries and create an owner-only asynchronous summary. It does not edit, regenerate, publish, or delete summaries.
Authentication and scope
Authenticate with the owner's bf_* personal Agent token through a stored profile or OCTO_BOT_TOKEN. Do not pass or rely on --space: the Summary service resolves both the human owner and Space from the bot token and applies the owner's existing Summary permissions.
Create a summary
Creation is a write operation. Confirm the requested channels and time range with the user before calling it. Only explicit sources are accepted; the service does not let the model search all owner channels implicitly.
Pass time_range and sources through --data, and always provide a stable idempotency key:
octo-cli summary create \
--idempotency-key project-weekly-2026w31 \
--data '{"title":"本周项目进展","topic":"整理决策、进展和风险","time_range":{"start":"2026-07-21T00:00:00+08:00","end":"2026-07-28T00:00:00+08:00"},"sources":[{"source_type":1,"source_id":"group-id"}]}'Reuse the same key only when retrying the exact same request body after an uncertain outcome. If any body field changes, generate a new key; reusing the old key with a changed body returns 409/40009. Never generate a fresh key merely because an otherwise unchanged first request timed out.
Source types are 1=group, 2=thread, and 3=DM. include_archived defaults to false. An optional origin channel must also be present in sources. Owner, bot identity, Space, source names, and participants are server-controlled; do not send uid, participants, source_name, or confirm_timeout_hours.
The result contains task_id with an initial pending status. Poll with summary get <task-id> until status is completed (3), failed (4), or cancelled (5), then use summary result <task-id>. Poll at most 60 times with a 5-second interval; if it is still pending after 5 minutes, report the task id and current status instead of continuing.
Treat 40301/40302 as a source authorization or Space mismatch. Treat 50301 as the create feature being disabled. Treat 409/40009 as key reuse with a changed body: preserve the existing task id for audit and use a new key only if the user still wants the modified request. Do not retry authorization or feature-disabled errors with altered identity or broader sources.
Show full SKILL.md (156 more words)Show less
Discover summaries
octo-cli summary list
octo-cli summary list --keyword "launch review" --page 1 --page-size 20
octo-cli summary list --status 3 --created-after 2026-07-01T00:00:00Z--keyword matches the summary title or topic. Results are page-based {total, items}; increment --page manually because --page-all is not available.
Choose a candidate using its title, topic, sources, participants, time range, and task_id. Do not assume a title match alone proves relevance.
Read and cite
octo-cli summary get <task-id>
octo-cli summary result <task-id>Use get for metadata plus the current visible result. Use result when the full current body and citations are needed.
When answering from a summary:
- Identify the summary by title and
task_id. - Attribute claims to the returned citation entry using its index, sender, sent time, source, and message sequence.
- Preserve the summary's citation marker such as
[1]or[P1]when useful. - Never invent missing surrounding conversation. Bot responses intentionally omit
context_beforeandcontext_after.
Treat 401 as an invalid/ineligible bot identity. Treat 403 or 404 as unavailable or not visible; do not infer the contents of a hidden summary.
Inspect exact flags and schemas when needed:
octo-cli schema summary.list
octo-cli schema summary.get
octo-cli schema summary.result© Mininglamp-OSS, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/octo-summary of Mininglamp-OSS/octo-cli.
Open the folder on GitHubat commit 6d21f11
Compare with similar skills
Octo Summary next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Octo Summary this skillMininglamp-OSS/octo-cli | 918 | — | ~1k | Automated safety check: Pass | Apache-2.0 | |
| Goosetown Researcher GitHubaaif-goose/goosetown | 155 | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| Crossref APIwentorai/research-plugins | 298 | 1 repos | ~1.5k | Automated safety check: Pass | MIT | |
| Exa Known Pitfallsjeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Collaborating With Geminiappautomaton/latex-arxiv-SKILL | 458 | 1 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Sciverseopendatalab/Sciverse-Agent-Tools | 120 | — | ~3k | Automated safety check: Pass | Custom licence |
Similar skills
Crossref API
wentorai/research-plugins
Resolve DOIs and retrieve publication metadata from CrossRef registry
Exa Known Pitfalls
jeremylongshore/tons-of-skills-marketplace
Audit an Exa integration for stale search types, unsafe secrets, ignored partial failures, unbounded content work, weak citations, and orphaned asynchronous resources.
Collaborating With Gemini
appautomaton/latex-arxiv-SKILL
Use the Gemini CLI to consult Gemini and delegate coding tasks for prototyping, debugging, and code review.
Sciverse
opendatalab/Sciverse-Agent-Tools
A skill your agent uses when the user needs academic paper retrieval — searching scientific literature by author/year/journal, finding paper chunks for RAG-style citations, or expanding original…
Research Lookup
davila7/claude-code-templates
Look up current research information using Perplexity's Sonar Pro Search or Sonar Reasoning Pro models through OpenRouter.
More from Mininglamp-OSS/octo-cli
All 11 skills in this repoOcto Loop
Mininglamp-OSS/octo-cli
A skill your agent uses when operating the Octo Loop control plane through the octo-cli loop commands: reading or writing Fleet tasks, comments, metadata, projects, and labels; dispatching work to…
Octo Docs
Mininglamp-OSS/octo-cli
Docs domain — create and govern documents, read and incrementally edit a doc's live body, read and edit spreadsheets including structural row/column edits, find & replace, cells, layout, shared…
Octo Drive
Mininglamp-OSS/octo-cli
Octo Drive — spaces, folders, file upload/download, online-document mounts, share links, invites, IM-attachment transfer.
Octo Files
Mininglamp-OSS/octo-cli
File operations (upload/download, presigned S3 credentials) plus bot housekeeping (register, set-commands, user-info, space-members, typing, heartbeat).
Octo HTML
Mininglamp-OSS/octo-cli
HTML docs domain (octo-doc) — create and govern self-contained interactive HTML documents, immutable versions, drafts, sharing, media, comments, and agent element edits.
Octo Mail
Mininglamp-OSS/octo-cli
OCTO Agent Mail operations for reading, searching, policy-aware sending, preparing drafts, and checking delivery status exclusively through octo-cli.
Related
Categories
Questions about Octo Summary
What does Octo Summary do?
Read, create, find, and cite Octo summaries through octo-cli. Octo Summary is an agent skill from Mininglamp-OSS/octo-cli. Read, create, find, and cite Octo summaries through octo-cli.
When should I use Octo Summary?
Octo Summary fits situations like: an agent needs to create an owner-only summary from explicit channels; discover summaries visible to its bot owner; inspect one summary; retrieve its current body.
How do I install Octo Summary in Claude Code?
Run `npx skills add Mininglamp-OSS/octo-cli --skill octo-summary -a claude-code`. Or copy the skill folder (skills/octo-summary in Mininglamp-OSS/octo-cli) into .claude/skills/octo-summary in your project. Claude Code loads it when a task matches its description.
How do I install Octo Summary in Codex?
Run `npx skills add Mininglamp-OSS/octo-cli --skill octo-summary -a codex`. Or copy the skill folder (skills/octo-summary in Mininglamp-OSS/octo-cli) into .agents/skills/octo-summary in your project. Codex loads it when a task matches its description.
Can I use Octo Summary in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Mininglamp-OSS/octo-cli --skill octo-summary -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/octo-summary, .gemini/skills/octo-summary, .github/skills/octo-summary and .opencode/skills/octo-summary in your project.
What does Octo Summary need to run?
Going by SKILL.md and its folder, Octo Summary needs credentials named OCTO_BOT_TOKEN. Our summary lists: A credential in OCTO_BOT_TOKEN.
Does Octo Summary access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Octo Summary safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Octo Summary use?
Octo Summary is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Octo Summary use?
About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Octo Summary?
Skills that share tags, products or a category with Octo Summary: Goosetown Researcher GitHub (aaif-goose/goosetown, 155 stars), Crossref API (wentorai/research-plugins, 298 stars), Exa Known Pitfalls (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Collaborating With Gemini (appautomaton/latex-arxiv-SKILL, 458 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Octo Summary?
Mininglamp-OSS (a GitHub organization) maintains it in Mininglamp-OSS/octo-cli, which has 918 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 10, 2026.
Source: Mininglamp-OSS/octo-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.