Scaling AI Agent Workflows: The Skillsmaxxing Framework
Greg Isenberggo watch the original →
the gist
To move beyond single-player AI, teams should treat agent skills as version-controlled SOPs stored in a GitHub repository and distributed via plugins, ensuring consistent, company-owned output.
Skills as Standard Operating Procedures (SOPs)
Remy argues that the primary cause of inconsistent AI output is the lack of structured, reusable instructions. He defines a "skill" as a markdown-based SOP that encapsulates a specific process—such as brand voice, formatting standards, or complex task sequences. By packaging these into discrete files, users move away from repetitive prompting and ensure that the AI consistently applies the same preferences, logic, and constraints across different sessions.
The "Microsoft Word" Problem of AI Distribution
Currently, most AI agent setups are "single-player." When an individual creates a high-performing prompt or skill, it remains trapped on their local machine. Sharing these via Slack, email, or cloud storage creates a versioning nightmare, where multiple copies of the same skill drift apart as users make independent edits. Remy compares this to the early days of file sharing before collaborative tools like Google Docs existed, noting that teams currently lack a central source of truth for their AI assets.
GitHub as the Central Source of Truth
To solve this, Remy advocates for storing all team skills in a centralized GitHub repository. By treating skills as code, teams gain the benefits of version control (allowing for rollbacks if a skill is accidentally degraded) and centralized management. This repository is then installed as a plugin within AI harnesses like Claude Code or Codex. With auto-update enabled, any improvement made to a skill in the repository is instantly pushed to every team member's local environment.
Building and Managing Plugin Infrastructure
Remy emphasizes that this process does not require deep software engineering expertise. He uses AI to generate the necessary JSON configuration files that turn a folder of markdown skills into a functional plugin. This setup allows for departmental separation—where marketing teams only install marketing-related skill bundles—and creates a scalable system where the company retains ownership of the workflow assets, even if individual employees leave the organization.
The Self-Improvement Loop
Beyond simple distribution, Remy suggests building a web application layer on top of the repository to track usage data. By monitoring which skills are frequently used versus those that sit idle, teams can identify bottlenecks and optimize their workflows. This "skill-maxxing" approach turns AI agent management into a data-driven process, allowing teams to refine their SOPs based on real-world performance metrics.