repowisemattpocock/skills

mattpocock / skills

Skills for Real Engineers. Straight from my .agents directory.

Shell★ 300,100
Use in your agentAsk this codebase

github.com/mattpocock/skillsIndexed at 49dd158Up to date with upstream

What is skills?

skills is a collection of agent skills for real software engineering work. It helps coding agents align with project requirements, use shared terminology, apply feedback loops, and manage software design. The repository primarily uses Shell, with JavaScript files and an npm package manifest.

Written by a model from the README and the source

187 files and 27 symbols in 2 modules, led by Shell (5 files) and JavaScript (2).

Start reading

Code health

9.5out of 10Excellent

This codebase scores 9.5 out of 10 for code health, which we rate excellent. It also scores maintainability 10.0 and static performance 10.0 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 1 of 187 files are git hotspots, and they average 9.0 — which is where the fixes pay off most.

Full health report

Use mattpocock/skills in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/mattpocock/skills
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is skills put together?")
  • get_why("why is skills structured this way?")

Explore skills

Key features of skills

  • skills provides grilling sessions through /grill-me and /grill-with-docs to help align an agent with the requested work.
  • skills supports shared project language and documentation through /grill-with-docs.
  • skills provides /tdd guidance for a red-green-refactor testing loop.
  • skills provides /diagnosing-bugs guidance for a phased debugging process.
  • skills is designed to be small, adaptable, composable, and usable with any model.

How mattpocock/skills works

Agent installation enters through plugin commands or the skills installer, which makes the skills available to an agent. The .agents/invocation.md file documents how skills are invoked, while .agents/install-block.md provides installation-related guidance. The skills directory holds the agent skill files, including skills/engineering/wizard/template.sh, which is a central implementation file for engineering workflow templates. The scripts directory contains supporting scripts used by the repository. The .agents/writing-docs.md file guides documentation work, and the .agents/adr directory stores architecture decision records that document repository decisions.

The codebase has 187 files and 27 symbols in 2 modules, led by Shell and JavaScript. Code health is 9.5 out of 10, rated excellent.

Getting started with skills

  1. Install skills as a Claude Code plugin.
    claude plugin install mattpocock-skills@claude-plugins-official
  2. Install skills through the Codex plugin marketplace.
    codex plugin marketplace add mattpocock/skills
  3. Add the skills plugin to Codex.
    codex plugin add mattpocock-skills@mattpocock
  4. Run the setup skill once per repository in your agent.

Commands copied from the README

mattpocock/skills FAQ

What is skills?

skills is a collection of agent skills for real software engineering work. It helps agents align requirements, use shared terminology, and apply disciplined development practices.

How does skills work?

skills provides invokable skills that guide agents through activities such as requirements questioning, documentation, testing, and debugging. Agents install the skills as plugins or through the skills installer.

How do I install skills?

Install skills with a supported agent plugin command or the skills installer. After installation, run /setup-matt-pocock-skills once per repository.

What language is skills written in?

skills is primarily written in Shell. The repository also includes JavaScript files and uses npm.

How is the skills code organized?

skills is organized mainly into the skills and scripts directories. The .agents directory holds invocation, installation, documentation, and architecture decision records.

Who is skills for?

skills is for people using Claude Code, Codex, and other coding agents to build and maintain software. It supports alignment, shared project language, testing, debugging, and design work.

What license does skills use?

skills uses the MIT license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of mattpocock/skills from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.