Agent skill

Octo Matter

by Mininglamp-OSS in Mininglamp-OSS/octo-cli

Matter (todo/task) domain — CRUD, status transitions, assignees, channels, timeline, and AI extract from chat messages.

Apache-2.0Auto-check passedBackend & APIs

Install Octo Matter

skills CLI

$ npx skills add Mininglamp-OSS/octo-cli --skill octo-matter -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install Mininglamp-OSS/octo-cli octo-matter --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/octo-matter .claude/skills/octo-matter && rm -rf skills-src

Use ~/.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/

Paste into Claude Code

Install the "octo-matter" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-matter into .claude/skills/octo-matter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-matter", 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

$skill-installer install https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-matter

Type 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.

skills CLI

$ npx skills add Mininglamp-OSS/octo-cli --skill octo-matter -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Mininglamp-OSS/octo-cli octo-matter --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/octo-matter .agents/skills/octo-matter && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "octo-matter" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-matter into .agents/skills/octo-matter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-matter", 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.

skills CLI

$ npx skills add Mininglamp-OSS/octo-cli --skill octo-matter -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Mininglamp-OSS/octo-cli octo-matter --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/octo-matter .cursor/skills/octo-matter && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "octo-matter" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-matter into .cursor/skills/octo-matter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-matter", 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

$ gemini skills install https://github.com/Mininglamp-OSS/octo-cli.git --path skills/octo-matter

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Mininglamp-OSS/octo-cli --skill octo-matter -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Mininglamp-OSS/octo-cli octo-matter --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/octo-matter .gemini/skills/octo-matter && rm -rf skills-src

Use ~/.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/

Paste into Gemini CLI

Install the "octo-matter" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-matter into .gemini/skills/octo-matter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-matter", 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.

GitHub CLI

$ gh skill install Mininglamp-OSS/octo-cli octo-matter

Installs 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).

skills CLI

$ npx skills add Mininglamp-OSS/octo-cli --skill octo-matter -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/octo-matter .github/skills/octo-matter && rm -rf skills-src

Use ~/.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/

Paste into GitHub Copilot

Install the "octo-matter" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-matter into .github/skills/octo-matter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-matter", 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.

skills CLI

$ npx skills add Mininglamp-OSS/octo-cli --skill octo-matter -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Mininglamp-OSS/octo-cli octo-matter --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Mininglamp-OSS/octo-cli.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/octo-matter .opencode/skills/octo-matter && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "octo-matter" agent skill from https://github.com/Mininglamp-OSS/octo-cli/tree/main/skills/octo-matter into .opencode/skills/octo-matter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octo-matter", 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-matter
GitHub stars: 918
Token cost: ~1.5k tokens
SKILL.md length: 421 words
Files: 1
Skills in repo: 11
Repo updated: Oct 10, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Matter (todo/task) domain — CRUD, status transitions, assignees, channels, timeline, and AI extract from chat messages.

Works in 9 steps: Core CRUD → Status transitions → Assignees → …
Backend & APIs work in your project
SKILL.md covers 1. Core CRUD, 2. Status transitions, 3. Assignees and 4. Channels, plus 5 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Octo Matter is an agent skill from Mininglamp-OSS/octo-cli. Matter (todo/task) domain — CRUD, status transitions, assignees, channels, timeline, and AI extract from chat messages. Load after octo-shared.

Its SKILL.md is about 1.5k 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. 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

Backend & APIs work in your project

Example prompts

“/octo-matter”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

Core CRUD
Status transitions
Assignees
Channels
Timeline
AI extract — create a matter from chat messages
Common patterns
Error recovery
Schema lookup

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 no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Octo Matter loads about 1.5k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 421 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~39
When it runs · the whole SKILL.md, loaded when a task matches: ~1.5k

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). 421 words, ~1,469 tokens.

Download SKILL.mdSave it as .claude/skills/octo-matter/SKILL.md (or your agent's skills folder).

name: octo-matter
description: Matter (todo/task) domain — CRUD, status transitions, assignees, channels, timeline, and AI extract from chat messages. Load after octo-shared.
version: 0.4.0
disabled: true

octo-matter — the matters domain

A matter is the Octo equivalent of a task or todo. The domain has 17 operations across five groups: core CRUD, status transitions, assignees, channels, and timeline. Plus one LLM helper: matter extract.

Backend: matters service at $OCTO_API_BASE_URL/api/v1/matters. Both App Bot and User Bot can call every operation in this domain.

1. Core CRUD

bash

octo-cli matter create --title "Fix login bug"                     # required: --title (≤500 chars)
octo-cli matter list   --status open --assignee-id me --limit 50   # cursor pagination
octo-cli matter get    <id>
octo-cli matter update <id> --title "..." --description "..."
octo-cli matter delete <id>                                        # soft delete

create also accepts --description (≤10 000), --assignee-ids (repeatable — supports me alias), --deadline (RFC3339), --remind-at (RFC3339), --source-channel-id, --source-channel-type (1=user, 2=group, 5=thread), --source-name.

list filters: --status, --assignee-id (me supported), --creator-id, --q <query>, --source-channel-id, --source-channel-type, --channel-id, --limit (default 20, max 100), --cursor.

2. Status transitions

There is no state machine — any status can move to any status.

bash

octo-cli matter transition <id> --status done
octo-cli matter close      <id>          # alias → --status done
octo-cli matter reopen     <id>          # alias → --status open
octo-cli matter archive    <id>          # alias → --status archived

Valid values: open, done, archived.

3. Assignees

bash

octo-cli matter assignee add    <id> --user-id <uid>
octo-cli matter assignee remove <id> <uid>

--user-id accepts me to self-assign. Adding a user who is already assigned returns DUPLICATE_ASSIGNEE (validation error — recover by listing current assignees first).

4. Channels

Link a matter to a chat channel so conversations show up in context.

bash

octo-cli matter channel link   <id> --channel-id <cid> --channel-type 1   # 1=user 2=group 5=thread
octo-cli matter channel link   <id> --channel-id <cid> --channel-type 2 --channel-name "#eng-ops"
octo-cli matter channel unlink <id> <channel_id>

5. Timeline

Timeline entries are the successor to comments. Simple text goes through --content; attachments, quoted messages, and channel context go through --data:

bash

octo-cli matter timeline add    <id> --content "Ping from oncall"
octo-cli matter timeline add    <id> --data '{
  "content":"see attached log",
  "attachments":[{"url":"https://…/log.txt","name":"log.txt","type":"text/plain"}]
}'
octo-cli matter timeline list   <id>                           # paginated
octo-cli matter timeline delete <id> <entry_id>

--content caps at 10 000 characters.

6. AI extract — create a matter from chat messages

matter extract hands a chat transcript to an LLM and returns a structured matter. Typical bot use:

bash

octo-cli matter extract --data '{
  "channel_type": 2,
  "channel_id":   "ch_abc",
  "creator_uid":  "<bot-owner-uid>",
  "msgs": [
    {"uid":"u_alice","text":"we need to fix login"},
    {"uid":"u_bob","text":"+1 by friday"}
  ]
}'

Critical: a bot must set creator_uid to its owner_uid, not its own bot_uid — the backend rejects the request otherwise. Capture owner_uid from the one-time octo-cli bot register response at publish (--jq '.data.owner_uid') and cache it (env/config); reuse the cached value rather than re-registering on every extract. Note bot user-info does not return it (it needs --uid and returns only {uid,name,avatar}).

Show full SKILL.md (150 more words)Show less

7. Common patterns

Self-scope with `me`

Anywhere an assignee UID is accepted, me resolves server-side to the caller's UID.

bash

octo-cli matter list --assignee-id me --status open

Cursor pagination

All list endpoints follow {data:[], pagination:{has_more, next_cursor}}. Let the CLI walk them:

bash

octo-cli matter list --status open --page-all
octo-cli matter timeline list <id> --page-all --page-limit 5

Pipe chains

bash

octo-cli matter list --status open --assignee-id me --jq '.data[].id' \
  | xargs -I{} octo-cli matter close {}

8. Error recovery

`error.code`	What to do
`MATTER_NOT_FOUND`	Confirm the id with `octo-cli matter list` before retrying.
`ASSIGNEE_NOT_FOUND`	The UID is wrong or not in the space. `octo-cli bot space-members` to verify.
`DUPLICATE_ASSIGNEE`	Already assigned — list current assignees and skip.
`FORBIDDEN`	Bot lacks space membership or owner-equivalent permission.
`SPACE_FORBIDDEN`	`OCTO_SPACE_ID` / `--space` points at a space the bot isn't in.
`VALIDATION_ERROR`	`error.detail.details` names the offending field; fix and retry.
`PAYLOAD_TOO_LARGE`	Body over 1 MB — trim description/timeline content.
`RATE_LIMITED`	Honour the cooldown window; the retry wrapper already waits once.

9. Schema lookup

When unsure about a flag or body shape:

bash

octo-cli schema matter.create
octo-cli schema matter.list
octo-cli schema matter.timeline.add

Everything in this skill is derived from those specs — if the schema says otherwise, trust the schema.

Files

Just SKILL.md in skills/octo-matter of Mininglamp-OSS/octo-cli.

Open the folder on GitHubat commit 6d21f11

Compare with similar skills

Octo Matter 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.

Octo Matter compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Octo Matter this skillMininglamp-OSS/octo-cli	918	—	~1.5k	Automated safety check: Pass	Apache-2.0	yesterday
Configuring Horizoncoollabsio/coolify	63k	4 repos	~898	Automated safety check: Pass	MIT	yesterday
Nestjs Best Practicesrolling-scopes/rsschool-app	10k	6 repos	~1.2k	Automated safety check: Pass	MIT	6 days ago
Sub2API AdminWei-Shaw/sub2api	44k	1 repos	~717	Automated safety check: Pass	LGPL-3.0	yesterday
Firecrawl Build Onboardingfirecrawl/firecrawl	190k	1 repos	~1.4k	Automated safety check: Notes	ISC	today
Obsidian BasesAtmosphere/atmosphere	3.8k	22 repos	~3.2k	Automated safety check: Pass	Apache-2.0	2 days ago

Similar skills

Configuring Horizon
coollabsio/coolify
A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.
63k GitHub starsUsed in 4 repos~898 tokens
Backend & APIsAuto-check passed
Nestjs Best Practices
rolling-scopes/rsschool-app
NestJS best practices and architecture patterns for building production-ready applications.
10k GitHub starsUsed in 6 repos~1.2k tokens
Backend & APIsAuto-check passed
Sub2API Admin
Wei-Shaw/sub2api
Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.
44k GitHub starsUsed in 1 repo~717 tokens
Backend & APIsAuto-check passed
Firecrawl Build Onboarding
firecrawl/firecrawl
Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.
190k GitHub starsUsed in 1 repo~1.4k tokens
Backend & APIsAuto-check: notes
Obsidian Bases
Atmosphere/atmosphere
Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.
3.8k GitHub starsUsed in 22 repos~3.2k tokens
Backend & APIsAuto-check passed
Fortify Development
coollabsio/coolify
ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.
63k GitHub starsUsed in 4 repos~1.9k tokens
Backend & APIsAuto-check passed

Questions about Octo Matter

What does Octo Matter do?

Matter (todo/task) domain — CRUD, status transitions, assignees, channels, timeline, and AI extract from chat messages. Octo Matter is an agent skill from Mininglamp-OSS/octo-cli. Matter (todo/task) domain — CRUD, status transitions, assignees, channels, timeline, and AI extract from chat messages.

When should I use Octo Matter?

Octo Matter fits situations like: backend & APIs work in your project.

How do I install Octo Matter in Claude Code?

Run `npx skills add Mininglamp-OSS/octo-cli --skill octo-matter -a claude-code`. Or copy the skill folder (skills/octo-matter in Mininglamp-OSS/octo-cli) into .claude/skills/octo-matter in your project. Claude Code loads it when a task matches its description.

How do I install Octo Matter in Codex?

Run `npx skills add Mininglamp-OSS/octo-cli --skill octo-matter -a codex`. Or copy the skill folder (skills/octo-matter in Mininglamp-OSS/octo-cli) into .agents/skills/octo-matter in your project. Codex loads it when a task matches its description.

Can I use Octo Matter 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-matter -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-matter, .gemini/skills/octo-matter, .github/skills/octo-matter and .opencode/skills/octo-matter in your project.

What does Octo Matter need to run?

SKILL.md names no scripts, command-line tools or credentials: Octo Matter is instructions for the agent only.

Does Octo Matter 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 Matter 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 Matter use?

Octo Matter 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 Matter use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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 Matter?

Skills that share tags, products or a category with Octo Matter: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 44k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Octo Matter?

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.

Install Octo Matter

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

octo-matter — the matters domain

1. Core CRUD

2. Status transitions

3. Assignees

4. Channels

5. Timeline

6. AI extract — create a matter from chat messages

7. Common patterns

Self-scope with me

Cursor pagination

Pipe chains

8. Error recovery

9. Schema lookup

Files

Compare with similar skills

Similar skills

More from Mininglamp-OSS/octo-cli

Related

Questions about Octo Matter

Self-scope with `me`