mrkeyoor.com_
Sun 06 Sept 02:51 UTC
Open Source6 min read

mattpocock/skills Crosses 252,000 Stars With Markdown Workflows

The 25-skill pack turns engineering habits into agent instructions. Its popularity shows demand for process, while its prompts still depend on agents obeying them.

The mattpocock/skills repository added 2,666 GitHub stars in the daily snapshot supplied to MrKeyoor. Its current plugin is a catalog of 25 Markdown procedures covering specification, debugging, testing and code review. GitHub's repository API showed 252,678 stars and 21,324 forks at reporting time.

The burst tracks interest in how a coding agent should behave once it enters a real repository. The project README describes files meant to be adapted and combined, with support for Claude Code, Codex and other agents through two different installation routes. A star is an expression of interest. It does not show that a procedure produces better software.

This project distributes instructions rather than an execution engine. A skill can tell an agent to stop for approval or run a test, while the host model and its tools perform those actions. The v1.2.3 plugin manifest is unusually readable: 18 engineering skill directories and seven productivity skill directories, each pointing to ordinary files in the repository.

A menu of engineering checkpoints

The collection covers more of the development cycle than the word "skills" might suggest. The manifest includes commands for questioning a request, writing a specification, cutting tickets, implementing changes, diagnosing bugs, reviewing code and handing work to a later session. Its setup skill also asks teams to record their issue tracker, triage labels and domain-document layout before the other engineering procedures start using them.

Pocock separates the catalog by who is allowed to invoke each item. According to the repository's invocation rules, a user-invoked skill runs only when a person names it. A model-invoked skill may be selected automatically when its description matches the task. The project encodes that difference in Claude frontmatter and in an adjacent agents/openai.yaml file for Codex.

That split gives developers a concrete control surface. Setup, planning and other deliberate workflows can require a typed command, while reusable disciplines can enter the agent's context automatically. The same invocation document says one skill may call another through the host's skill tool only when the target is model-invoked. User-only commands cannot be reached through that chain.

The setup process is also a reminder that these files may lead to repository changes. The setup instructions inspect Git configuration and existing agent documents, present proposed content for approval, then write tracker and domain documentation. Installing a prompt file is a small act; granting the resulting workflow access to an issue tracker or working tree is the larger decision.

The useful details are the stopping rules

The TDD skill is specific about where an agent must pause. Before writing a test, it requires the agent to identify the public seams under test and confirm them with the user. It then prescribes one vertical slice at a time: a failing test, the smallest implementation that passes, then another slice. The TDD procedure rejects tests tied to private implementation details and assertions that recompute the expected answer with the same logic as the code.

The debugging procedure puts even more weight on evidence. Its first phase requires a fast, deterministic command that can reproduce the exact symptom. Only after that loop exists does the agent minimise the case, rank three to five falsifiable hypotheses and instrument the relevant boundary. The diagnosing-bugs skill also tells the agent to redact secrets from commands, logs and captured artifacts before showing them.

Code review is split into two independent readings of the same change. One checks repository standards and a defined set of code smells; the other checks the patch against its originating issue or specification. The code-review skill sends those jobs to separate subagents and reports the results side by side, so a clean implementation cannot hide that the wrong feature was built, and a faithful feature cannot hide a standards breach.

Order is a recurring constraint across the files. diagnosing-bugs blocks hypotheses until a reproduction command exists, while tdd blocks implementation until a test fails. The repository's README ties these pauses to common agent failures and treats the instructions as files developers can inspect and edit inside their projects.

Installation chooses an update policy

Claude Code users can install the full set as a managed plugin from its official marketplace. Codex and other supported agents use npx skills@latest add mattpocock/skills, choose individual skills and copy them into the project. The installation section warns against using both routes because duplicate skill names are the result.

The difference is operational. Claude's managed bundle is read-only and receives publisher updates, while copied files remain under the team's control and update only when requested. Our review of mattpocock/skills covers the setup reality, including a sandbox install and the absence of a standard build or test command. Teams choosing the copied route can inspect each change before bringing it into repositories with local rules.

A native Codex plugin remains deferred for a technical reason documented by the maintainer. The repository groups promoted skills under engineering and productivity, alongside draft, deprecated and miscellaneous buckets. Its distribution decision record says Claude's manifest can list many directories, while the tested Codex manifest accepted one path and discarded a proposed set of symlinks during installation. The cross-agent route therefore copies selected files through the skills installer.

Written gates still need external proof

Version 1.2.3's package.json has scripts for Changesets, version updates and checking that plugin versions match. It has no test or build script. The release workflow installs dependencies and opens a version pull request or creates a tag. The checked-in package scripts provide no evaluation of how often supported agents follow each procedure or whether the same skill behaves consistently across models.

An open issue shows why green code checks can leave a gap. The reporter of issue 923 says an architecture workflow passed types, tests and review while dropping a conditional UI branch or prop passthrough. The proposed fix would capture screenshots and accessibility trees before an edit and compare them afterward. It is a first-hand issue report, rather than an independently reproduced benchmark, but it identifies a clear boundary in a review flow that inspects code instead of rendered pixels.

A second report concerns durable planning state. In issue 944, a Wayfinder user says a growing GitHub issue body crossed the service's character limit and was silently truncated, removing about 59 index lines and two sections. The report proposes a size check, bounded index entries and pagination. That failure is concrete: a written instruction can define a canonical artifact while missing a limit imposed by the service that stores it.

Prompt text cannot close these gaps by itself. A skill can require a failing test, yet only the repository's test suite decides whether the signal reaches the right behavior. It can demand approval, yet the host decides how that approval is represented. The plugin manifest packages procedures; CI and permissions supply enforcement, with a human accountable for review.

What the surge tells developers

The repository was created on February 3, 2026, according to GitHub's metadata, and the brief's 2,666-star daily gain is about 1.1 percent of its current total. That is a sharp one-day movement for a project already above 252,000 stars. It shows that agent workflow files can attract attention on the scale usually associated with executable developer tools. It cannot settle whether a particular skill saves time or prevents defects.

The repository treats agent behavior as project configuration that a team can review. Developers can read the TDD rules, remove assumptions that do not fit their codebase and add checks for local failure modes. The managed-plugin route trades that control for easier updates; the copied route makes the team responsible for reviewing upstream changes.

Watch the next releases for a manifest validator, cross-agent evaluations, a UI-preservation patch for issue 923, and a size guard or pagination for issue 944. The distribution decision record leaves native Codex packaging unresolved as well. Until those changes land, 252,000 stars measures reach; the open issues define where the procedures still depend on local safeguards.

We reviewed this

  1. codex — our honest review
  2. claude-code — our honest review
  3. skills — our honest review

Sources

  1. mattpocock/skills repository
  2. GitHub repository metadata for mattpocock/skills
  3. mattpocock/skills README
  4. Claude plugin manifest
  5. Model-invoked versus user-invoked design
  6. Repository setup skill
  7. Test-driven development skill
  8. Diagnosing bugs skill