init-workflow

Configures milestone workflow settings in a project's CONTRIBUTING.md through detection and interview.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/sagittaras/agentic-workflow --skill init-workflow-sagittaras
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-workflow
Source: https://github.com/sagittaras/agentic-workflow/tree/main/skills/init-workflow
Command: npx skills add https://github.com/sagittaras/agentic-workflow --skill init-workflow-sagittaras

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a milestone-based agentic workflow requires every project to declare its forge, repository, branching rules, agent map, verification commands, and issue labels — without a shared configuration, every other workflow skill would have to ask the same questions on every run. ## Core Features & Use Cases - Automatic detection: Runs a forge-detection script to identify the git forge (GitHub or Gitea), host, owner/repo, and default branch, then confirms findings with the user instead of guessing. - Guided configuration interview: Derives area mappings from existing project agents, extracts verification commands from real project files (package.json, Makefile, pyproject.toml, etc.), and asks only about what cannot be detected. - Safe writes and label creation: Creates or updates only the Workflow (sagittaras) section of CONTRIBUTING.md without touching the rest of the file, migrates older config locations, and creates missing issue labels in the tracker only after confirmation. - Use Case: A developer clones a repository and wants to start planning milestones with the sagittaras plugin. Running this skill once produces a complete workflow configuration that plan-milestone, run-milestone, and verify-issue all read from. ## Quick Start Ask the assistant to set up the milestone workflow configuration for this project.

Frequently Asked Questions about init-workflow

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

FAQPage Schema
How do I set up milestone workflow configuration for a project?

Run the init-workflow skill once per project. It detects the forge and repository, derives area and agent mappings, asks about anything it cannot detect, and writes a Workflow section into CONTRIBUTING.md that all other workflow skills read.

How does the skill detect GitHub or Gitea repositories?

It runs the bundled forge-detect.sh script, which inspects the git remote to determine the forge type, host, owner/repo, and default branch. If detection fails or returns unknown, the skill asks the user instead of guessing.

Does init-workflow overwrite an existing CONTRIBUTING.md?

No. It only creates or edits the Workflow (sagittaras) section and never touches the rest of the file. Existing configurations are updated subsection by subsection, each change requiring explicit user confirmation.

Can init-workflow create issue labels in the tracker?

Yes, but only after user confirmation. It proposes missing type labels based on Conventional Commits and area labels from the detected area map, creating them via gh CLI scripts on GitHub or Gitea MCP tools on Gitea.

What happens if the project has no agents defined?

The skill skips the Agents subsection entirely rather than writing an empty table. The milestone runner then falls back to dispatching work to a generic subagent, and the user can add agents later with the write-agent skill.

Why does init-workflow fail when the directory is not a git repository?

The workflow depends on branches and pull requests, so the detection script exits with code 2 when no git repository exists. The skill reports this and stops, since there is nothing meaningful to configure without version control.