Matt Pocock Skills Adapt

中文说明

An unofficial, cross-agent adaptation of Matt Pocock's Skills for Real Engineers, packaged for Codex, Claude Code, Hermes Agent, and other Agent Skills-compatible harnesses.

This repository keeps all 22 upstream skills, preserves the MIT license and attribution, and makes six core project-flow skills available for automatic routing where the host supports implicit invocation:

• ask-matt
• grill-with-docs
• to-spec
• to-tickets
• wayfinder
• implement

The remaining skills keep their upstream roles. Automatic selection differs by agent, so explicit $skill-name or /skill-name invocation remains supported and reliable.

Why this adaptation exists

This distribution has two goals:

1. Make the complete 22-skill workflow easy to share and install across multiple agents.
2. Run the same planning and engineering workflow inside Hermes Agent, alongside Lark/Feishu CLI skills.

The repository is flattened to skills/<skill-name>/SKILL.md. This layout works as a Hermes Skill Tap and remains discoverable by Agent Skills installers.

Install

Codex and other agents supported by skills.sh

Interactive installation:

npx skills@latest add octopus117/mattpocock-skills-adapt

Install all skills globally without prompts:

npx skills@latest add octopus117/mattpocock-skills-adapt -g -y

Or run:

./scripts/install-codex.sh

Restart the agent after installation so its skill index refreshes.

Claude Code

Inside Claude Code:

/plugin marketplace add octopus117/mattpocock-skills-adapt
/plugin install mattpocock-skills-adapt@octopus117

You can also use the skills.sh installation path above and select Claude Code as the target.

Hermes Agent

Clone this repository and run:

./scripts/install-hermes.sh

The script adds this repository as a Hermes Skill Tap and installs all 22 skills under the mattpocock-adapt category. Start a new Hermes session after installation.

The adapted setup-matt-pocock-skills writes only project configuration under docs/agents/; it does not rewrite repository-wide agent instruction files. This keeps the setup flow portable and compatible with Hermes security scanning.

Manual equivalent:

hermes skills tap add octopus117/mattpocock-skills-adapt
hermes skills install octopus117/mattpocock-skills-adapt/ask-matt --category mattpocock-adapt -y

Hermes follows the Agent Skills standard, indexes installed skill descriptions, supports explicit /skill-name commands, and may load relevant skills from natural-language requests. Hermes does not use Codex-specific agents/openai.yaml; its own skill index controls discovery.

Using with Lark/Feishu CLI in Hermes

These 22 skills manage project discovery, planning, engineering, testing, and review. They do not replace the Lark/Feishu skills. A typical combined flow is:

ask-matt
  -> grill-with-docs or wayfinder
  -> to-spec
  -> to-tickets
  -> implement
  -> Hermes selects lark-base, lark-doc, lark-task, or another Lark skill

ask-matt routes among the Matt Pocock skills. Hermes itself selects globally installed Lark/Feishu skills when the concrete task matches them.

Before using Lark from Hermes, verify that both the CLI and the skills are visible:

lark-cli --version
hermes skills list | grep lark

Example request:

Plan a Feishu-first project management system, turn the approved design into tickets, then build the Base and task workflow with the installed Lark skills.

Compared with Superpowers

This project and Superpowers overlap, but they optimize for different working styles.

What is similar

• Both provide composable skills that agents can select automatically.
• Both favor clarification before implementation, written specifications, TDD, debugging discipline, verification, and code review.
• Both turn a rough idea into an executable engineering workflow rather than jumping directly into code.
• Both can be installed across multiple coding-agent environments.

What is different

Area	Matt Pocock Skills Adapt	Superpowers
Control model	Route only when the situation benefits from a workflow; clear tasks may execute directly.	A bootstrap rule requires checking and invoking relevant skills before any response or action.
Entry point	ask-matt chooses a suitable skill or flow when project direction is unclear.	using-superpowers establishes mandatory process rules from session start.
Design gate	grill-with-docs is selected for unclear project work; it is not forced on every simple task.	brainstorming is a hard gate before creative implementation, including small changes.
Planning artifact	Specs, issue-tracker tickets, blocking edges, and wayfinder decision maps.	Local design documents and detailed bite-sized implementation plans.
Execution style	implement uses TDD and code review; the host agent decides how to execute.	Strong emphasis on worktrees, subagent-driven development, task-by-task review, and branch finishing.
Scope	Engineering plus reusable productivity and domain-modeling skills.	A complete, prescriptive software-development methodology.
Philosophy	Lower friction, selective process, user instructions remain primary.	Mandatory workflow discipline designed to prevent skipping process steps.

This adaptation is not a fork of Superpowers and contains no Superpowers code. The comparison is based on its public workflow documentation and is included to help users choose the right operating model.

Workflow map

New or unclear project
  -> ask-matt
     -> grill-with-docs       # clarify a project with a codebase
     -> wayfinder             # map a huge multi-session effort
     -> research/prototype    # answer evidence or design questions
  -> to-spec                  # formalize settled decisions
  -> to-tickets               # create tracer-bullet work units
  -> implement                # build with TDD and code review

Other entry points
  -> diagnosing-bugs
  -> triage
  -> improve-codebase-architecture
  -> code-review
  -> resolving-merge-conflicts

Invocation model

This adaptation keeps seven specialist or infrequent workflows explicit by default:

triage
improve-codebase-architecture
setup-matt-pocock-skills
grill-me
handoff
teach
writing-great-skills

The other 15 skills are available for model invocation where the host supports it. Host behavior is authoritative: some agents use frontmatter flags, some use their own skill index, and all supported agents allow explicit invocation.

Validation

Run:

python3 scripts/validate.py

The validator checks the 22-skill inventory, frontmatter names and descriptions, plugin paths, adapted implicit-invocation settings, and common accidental secret files.

Attribution and license

The skill content is derived from mattpocock/skills, originally authored by Matt Pocock and released under the MIT License. Adaptation work, packaging, invocation metadata, documentation, and installation helpers are maintained by octopus117.

See LICENSE and NOTICE.