skills-first-workflow

Verify prerequisite skills and configure AGENTS.md and README.md before implementation.

1|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/mcj-coder/development-skills --skill skills-first-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skills-first-workflow
Source: https://github.com/mcj-coder/development-skills/tree/main/skills/skills-first-workflow
Command: npx skills add https://github.com/mcj-coder/development-skills --skill skills-first-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that all development work strictly adheres to a "skills-first" approach, mandating the loading and verification of prerequisite skills before any implementation begins, thereby preventing common errors and ensuring a robust development process.

Core Features & Use Cases

  • Prerequisite Enforcement: Automatically verifies the installation and loading of essential skills like Superpowers and using-superpowers.
  • Repository Initialization/Migration: Guides the creation or updating of AGENTS.md and README.md for new or existing repositories.
  • Process Skill Routing: Ensures the correct process skills (e.g., TDD, verification) are applied before implementation.
  • Use Case: When starting any new task in a repository, this skill is loaded first. It checks if Superpowers is set up, if AGENTS.md is correctly configured, and if necessary process skills are loaded, automatically fixing issues or providing clear instructions if they are not.

Quick Start

Load the skills-first-workflow skill as the very first action when entering any repository.

Frequently Asked Questions about skills-first-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce a skills-first workflow before starting development tasks?

You can enforce a skills-first workflow by loading a verification skill that automatically checks if prerequisite process skills are loaded and repository configuration files like AGENTS.md and README.md are correctly set up before implementation begins.

What is process automation for prerequisite skill loading in a repository?

Process automation for prerequisite skill loading verifies that required development skills, such as Superpowers and TDD processes, are installed and active before any code implementation starts, automatically fixing configuration issues or providing setup instructions.

Do I need Superpowers installed to automate repository setup?

Yes, you need Superpowers and the using-superpowers skill installed and loaded, as they are mandatory prerequisites for enforcing the skills-first workflow and automating repository setup.

How do I automatically generate AGENTS.md and README.md for new repositories?

You can automatically generate or update AGENTS.md and README.md by loading the skills-first workflow skill, which guides repository initialization and ensures configuration adherence for both new and existing repositories.

What's the best way to ensure test-driven development processes are applied before implementation?

The best way to ensure test-driven development processes are applied is to use a workflow enforcement skill that routes to correct process skills, verifying TDD and verification skills are loaded before implementation begins.

Why does my repository setup fail when prerequisite skills are not loaded?

Repository setup fails because the skills-first workflow strictly mandates loading and verifying prerequisite skills before any implementation begins to prevent common development errors and ensure a robust process.