Agentic Workflow Creator

Create natural language GitHub Actions workflows using the agentic workflows pattern from GitHub Next.

6 stars

Best use case

Agentic Workflow Creator is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Create natural language GitHub Actions workflows using the agentic workflows pattern from GitHub Next.

Teams using Agentic Workflow Creator should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/agentic-workflow/SKILL.md --create-dirs "https://raw.githubusercontent.com/pskoett/measuring-ai-proficiency/main/.claude/skills/agentic-workflow/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/agentic-workflow/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How Agentic Workflow Creator Compares

Feature / AgentAgentic Workflow CreatorStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Create natural language GitHub Actions workflows using the agentic workflows pattern from GitHub Next.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Agentic Workflow Creator

Create natural language GitHub Actions workflows using the agentic workflows pattern from GitHub Next.

## Description

This skill creates markdown-based agentic workflows that can be compiled to GitHub Actions YAML. Instead of writing traditional scripts, you describe repository behaviors in plain language.

## Usage

```
/agentic-workflow <task description>
```

Or invoke with specific parameters:
```
/agentic-workflow --trigger "issue opened" --task "triage and label issues"
```

## Workflow Structure

Agentic workflows use this markdown format:

```markdown
# Workflow Name

Brief description of what this workflow does.

## Triggers

- on: [trigger events]

## Permissions

- issues: write
- pull-requests: write
- contents: read

## Safe-outputs

- Maximum 1 pull request per run
- Only modify files in specific directories

## Tools

- edit: Modify files in the repository
- web-fetch: Fetch external documentation
- web-search: Search for solutions

## Instructions

Natural language instructions for the agent to follow.
Be specific about:
- What to look for
- How to make decisions
- What actions to take
- When to stop or escalate
```

## Best Use Cases

Agentic workflows work best for:

1. **Issue Triage** - Auto-label, assign, and categorize issues
2. **Quality Assurance** - Propose tests for uncovered code paths
3. **Accessibility** - Scan and suggest WCAG fixes
4. **Documentation** - Sync docs with code changes
5. **Dependency Updates** - Review and merge safe updates
6. **Code Review** - Automated first-pass reviews

## Examples

### Issue Labeler

```markdown
# Auto-Label Issues

Automatically categorize and label new issues based on content.

## Triggers

- on: issues.opened

## Permissions

- issues: write

## Safe-outputs

- Maximum 3 labels per issue
- Never close issues automatically

## Tools

- None required (uses GitHub API only)

## Instructions

When a new issue is opened:

1. Read the issue title and body
2. Categorize as: bug, feature, question, or documentation
3. Add appropriate labels:
   - `bug` for error reports and broken functionality
   - `enhancement` for feature requests
   - `question` for help requests
   - `docs` for documentation issues
4. Add priority label if keywords suggest urgency:
   - `priority:high` if contains "critical", "urgent", "blocking"
   - `priority:low` if contains "minor", "nice-to-have"
5. Add component labels based on file paths mentioned
6. Comment acknowledging the issue was triaged
```

### Test Coverage Improver

```markdown
# Suggest Missing Tests

Analyze PRs and suggest tests for uncovered code paths.

## Triggers

- on: pull_request.opened
- on: pull_request.synchronize

## Permissions

- pull-requests: write
- contents: read

## Safe-outputs

- Maximum 1 review comment per file
- Only suggest, never commit tests directly

## Tools

- edit: Read source files

## Instructions

For each changed file in the PR:

1. Identify new functions, methods, or branches
2. Check if corresponding test files exist
3. Analyze existing test coverage
4. For uncovered code paths, suggest specific test cases:
   - Unit tests for pure functions
   - Integration tests for API endpoints
   - Edge cases for error handling
5. Post suggestions as review comments on specific lines
6. Be constructive - explain why each test matters
```

## Output Location

Workflows are created in:
- `.github/workflows/` (as `.md` files for agentic execution)
- Can be compiled to YAML with `gh aw compile`

## Security Principles

1. **Explicit permissions** - Never assume access, always declare
2. **Safe-outputs** - Constrain what the workflow can do
3. **Auditability** - Generated YAML should be inspectable
4. **Minimal tools** - Only enable tools actually needed
5. **Human oversight** - Complex actions should request review

## References

- [GitHub Next: Agentic Workflows](https://githubnext.com/projects/agentic-workflows/)
- Uses MCP-based tools for GitHub-native integration
- Compatible with Claude Code and OpenAI Codex engines

Related Skills

eval-creator

6
from pskoett/measuring-ai-proficiency

[Beta] Creates permanent eval cases from promoted learnings and runs regression checks against them. Turns failures into test cases that prevent silent regression. This is the outer loop's regress-test step. Use when a learning is promoted and has a clear pass/fail condition, or on cadence to verify promoted rules still hold.

verify-gate

6
from pskoett/measuring-ai-proficiency

Runs project compile, test, and lint commands between implementation and quality review. Gates simplify-and-harden behind machine verification. If checks fail, routes back to implementation with diagnostics for a fix loop. If checks pass, signals ready for the quality pass. Use after any implementation work completes and before simplify-and-harden. Essential for the inner loop's verify step.

use-agent-factory

6
from pskoett/measuring-ai-proficiency

How to drive the 14-workflow agent factory in this repo from a Claude session. Covers: when to use the factory vs. direct edits, how to start the chain, where the human gates are, how to pick an implementer, how to recover from stuck PRs, and all the failure modes learned to date. Use this skill when the user asks you to ship a feature, fix, or refactor through the factory; when they reference an existing issue or PR in the factory chain; when a workflow is stuck or misbehaving; or when you need to file issues or plan files that the factory will pick up. Do NOT use this skill for: single-file scratch edits on an untracked branch, research questions, one-shot script runs, or any work that does not produce a PR to main.

simplify-and-harden

6
from pskoett/measuring-ai-proficiency

Post-completion self-review for coding agents that runs simplify, harden, and micro-documentation passes on non-trivial code changes. Use when: a coding task is complete in a general agent session and you want a bounded quality and security sweep before signaling done. For CI pipeline execution, use simplify-and-harden-ci.

pre-flight-check

6
from pskoett/measuring-ai-proficiency

[Beta] Session-start scan that surfaces relevant learnings, recent errors, and eval status before work begins. Bridges the outer loop back into the inner loop by making accumulated knowledge visible at task start. Activated via SessionStart hook or manually before major tasks.

plan-interview

6
from pskoett/measuring-ai-proficiency

Ensures alignment between user and Claude during feature/spec planning through a structured interview process. Use this skill when the user invokes /plan-interview before implementing a new feature, refactoring, or any non-trivial implementation task. The skill runs an upfront interview to gather requirements across technical constraints, scope boundaries, risk tolerance, and success criteria before any codebase exploration. Do NOT use this skill for: pure research/exploration tasks, simple bug fixes, or when the user just wants standard planning without the interview process.

measure-ai-proficiency

6
from pskoett/measuring-ai-proficiency

Assess and improve repository AI coding proficiency and context engineering maturity. Use when users ask about: (1) AI readiness or AI maturity assessment, (2) context engineering quality or improvement, (3) CLAUDE.md, .cursorrules, or copilot-instructions files, (4) measuring how well a repo is prepared for AI coding assistants, (5) recommendations for improving AI collaboration, (6) what context files to add, or (7) comparing their repo to AI proficiency best practices.

learning-aggregator

6
from pskoett/measuring-ai-proficiency

[Beta] Cross-session analysis of accumulated .learnings/ files. Reads all entries, groups by pattern_key, computes recurrence across sessions, and outputs ranked promotion candidates. This is the outer loop's inspect step — it turns raw learning data into actionable gap reports. Use on a regular cadence (weekly, before major tasks, or at session start for critical projects). Can be invoked manually or scheduled.

intent-framed-agent

6
from pskoett/measuring-ai-proficiency

Frames coding-agent work sessions with explicit intent capture and drift monitoring. Use when a session transitions from planning/Q&A to implementation for coding tasks, refactors, feature builds, bug fixes, or other multi-step execution where scope drift is a risk.

customize-measurement

6
from pskoett/measuring-ai-proficiency

Customize AI proficiency measurement for your specific repository through a guided interview. Use when: setting up measure-ai-proficiency for a new repo, adjusting thresholds for your team's size, hiding irrelevant recommendations, or mapping custom file names to standard patterns.

context-surfing

6
from pskoett/measuring-ai-proficiency

Monitors context window health throughout a session and rides peak context quality for maximum output fidelity. Activates automatically after plan-interview and intent-framed-agent. Stays active through execution and hands off cleanly to simplify-and-harden and self-improvement when the wave completes naturally or exits via handoff. Use this skill whenever a multi-step agent task is underway and session continuity or context drift is a concern. Especially important for long-running tasks, complex refactors, or any work where degraded context would silently corrupt the output. Trigger even if the user doesn't say "context surfing" — if an agent task is running across multiple steps with intent and a plan already established, this skill is live.

git-workflow

144923
from affaan-m/everything-claude-code

Git workflow patterns including branching strategies, commit conventions, merge vs rebase, conflict resolution, and collaborative development best practices for teams of all sizes.

DevelopmentClaude