Skip to content
cccskills
FreePublished on GitHubEnglish overview

software-factory

Use this skill to plan a system of agents that handles software work from tickets to merged code. It defines shared terms for tasks, runs, and supporting services, and guides you in assigning products to each service slot and adding automation gradually.

OriginalShow the original description

Shared language for designing a software factory: the tasks it runs and the services it plugs into.

mattpocock/skills308,707 stars(GitHub 308,707 + cccskills 0)
Works withGitHub

Run score Not tested

See how to install

Good for

  • Planning an agent system for handling tickets and pull requests
  • Choosing services for a software automation setup
  • Defining task triggers, handoffs, and human review points

Overview

What it does

This skill helps design a software factory: a system where agents handle work that starts from tickets, pull requests, or schedules. It gives you shared terms for the work itself (tasks), the events that start it (triggers), and each execution (runs). It also clarifies the roles of the ticket tracker, git host, orchestrator, runner, and optional observability platform.

For each task, you consider what it reads and writes, what it starts next, where a person reviews the result, and how duplicate runs are prevented. The design also accounts for automated checks and automated review, so you can expand automation in stages. Product choices can be mapped to each service role.

When it helps

Use it when you want agents to triage tickets, review pull requests, or move software work through a defined process. It can also help compare service setups and decide where people need to check the work. If you have not chosen a starting point, the skill refers to task examples for common problems.

Example requests

  • "Design a software factory to handle untriaged tickets."
  • "For this task, list its triggers, the services it reads and writes, and the points where a person reviews the work."

Notes

Product information needed for a design should be checked against the attached service surveys, followed by research into current options.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Document check

AI checked the SKILL.md for operations that need care and for setup requirements. The score comes only from actually running the skill (hands-on test).

SafetyAre sending data, deleting files, and running commands disclosed?
AGoodIt specifies gradual triggers, automated checks, human review, and a cap on run loops.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt requires consulting service surveys and researching current product options; setup steps are not given.

Not counted in the score. Rated by AI (OpenAI Codex) as of Nov 1, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (6)

  • SKILL.md5.9 KB
  • EXAMPLE-TASKS.md3.6 KB
  • GIT-HOSTS.md7.5 KB
  • OBSERVABILITY-PLATFORMS.md7.7 KB
  • RUNNERS.md8.5 KB
  • TICKET-TRACKERS.md8.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ask-matt

FreeSummary

Choose which related skill to use and in what order for planning, building, debugging, or maintaining software. It explains routes through the available workflows and helps select the next step based on your situation and project size.

  • Choosing a workflow from idea to implementation
  • Finding the right starting point for bug investigation
  • Planning a build that spans multiple sessions
mattpocock/skills311.2KUpdated Oct 30, 2026

chief-of-staff

FreeSummary

Coordinate subagents, separate agents assigned tasks, to pursue a long-running goal in one session. Maintain dialogue with the user while improving working conditions, shared rules, and access to information needed for future tasks.

  • Coordinating agents around a long-term goal
  • Continuing user dialogue during background work
  • Improving shared rules and working conditions
mattpocock/skills308.7KUpdated Oct 31, 2026

claude-handoff

FreeSummary

Summarize an ongoing conversation and launch a fresh background agent to continue the work. The handoff includes the next focus, references to existing documents, and suggested skills, with sensitive information removed.

  • Continue ongoing work with a fresh agent
  • Hand off work with a specific next focus
  • Organize document references for the next session
mattpocock/skills311.2KUpdated Oct 30, 2026

code-review

FreeSummary

Review code changes from a chosen Git reference against two separate criteria: documented coding standards and the original requirements. Independent reviewers check each criterion, then present findings separately so convention problems and requirement gaps remain visible.

  • Reviewing changes on a branch or pull request
  • Checking changes since a chosen commit or tag
  • Checking compliance with documented coding standards
mattpocock/skills311.2KUpdated Oct 30, 2026

codebase-design

FreeSummary

Design modules that offer substantial behavior through a small interface, the rules callers must understand. Use shared design terms to simplify usage, contain complexity, choose where implementations can vary, and make behavior easier to test.

  • Simplifying a module's interface
  • Bringing scattered complexity into one module
  • Choosing where implementations can be swapped
mattpocock/skills311.2KUpdated Oct 30, 2026

diagnosing-bugs

FreeSummary

Investigate difficult bugs and performance slowdowns by building a repeatable test or script that detects the exact symptom. Reduce the failing case, compare possible causes, and verify the fix with checks that catch the bug if it returns.

  • Investigating an error that is hard to reproduce
  • Finding the cause of a performance slowdown
  • Testing an intermittent failure repeatedly
mattpocock/skills311.2KUpdated Oct 30, 2026

See all skills by mattpocock

Report a problem with this skill