https://github.com/docutray/devflow-skill
Complete agile development workflow commands for Claude Code. Framework-agnostic slash commands for GitHub-based development: research, epic planning, feature specs, implementation, validation, and PR review.
https://github.com/docutray/devflow-skill
agile-development automation ci-cd claude-code claude-code-plugin code-review continuous-integration developer-tools development-workflow devops github-integration jest productivity pytest python quality-assurance slash-commands testing typescript vitest
Last synced: 17 days ago
JSON representation
Complete agile development workflow commands for Claude Code. Framework-agnostic slash commands for GitHub-based development: research, epic planning, feature specs, implementation, validation, and PR review.
- Host: GitHub
- URL: https://github.com/docutray/devflow-skill
- Owner: docutray
- Created: 2025-10-27T17:56:56.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-02-03T15:03:44.000Z (4 months ago)
- Last Synced: 2026-02-04T04:57:40.655Z (4 months ago)
- Topics: agile-development, automation, ci-cd, claude-code, claude-code-plugin, code-review, continuous-integration, developer-tools, development-workflow, devops, github-integration, jest, productivity, pytest, python, quality-assurance, slash-commands, testing, typescript, vitest
- Language: Python
- Size: 137 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# DevFlow Skill
Portable Agent Skill for agile development workflows with GitHub integration. DevFlow works with skills-compatible agents via `npx skills` and keeps Claude Code slash commands through a compatibility plugin.
## Installation
### Agent Skills
```bash
npx skills add https://github.com/docutray/devflow-skill --skill devflow
```
### Claude Code
```bash
/plugin marketplace add docutray/devflow-skill
/plugin install devflow@docutray-skills
```
This installs the `devflow` skill and exposes compatibility slash commands such as `/devflow:feat`, `/devflow:dev`, `/devflow:check`, and `/devflow:review-pr`.
## Version
Current version: `2.0.0`
## What DevFlow Provides
DevFlow provides a structured workflow from research and planning through implementation, validation, and PR review.
### Standard Flow
```mermaid
flowchart LR
setup["/devflow:devflow-setup"] --> feat["/devflow:feat"]
feat --> issue["GitHub issue"]
issue --> dev["/devflow:dev"]
dev --> pr["Pull request"]
dev --> check["/devflow:check"]
check --> pr
pr --> review["/devflow:review-pr"]
```
```bash
# Claude Code command UX
/devflow:devflow-setup
/devflow:feat feature-name
/devflow:dev issue#123
/devflow:check
/devflow:review-pr 45
```
In Codex and other Agent Skills clients, ask naturally: "Use DevFlow to implement issue #123" or "Use DevFlow to review PR #45".
## Example Usage
### Claude Code
After installing the Claude Code marketplace plugin, use the namespaced slash commands:
```bash
/devflow:devflow-setup
/devflow:feat add-invoice-export --type=feat --priority=high
/devflow:dev issue#123 --worktree --full-validation
/devflow:review-pr 45 --fix-issues
```
### Codex
After installing the skill with `npx skills`, ask Codex to use DevFlow in natural language:
```text
Use DevFlow to configure this repository.
Use DevFlow to create a GitHub issue for adding invoice export.
Use DevFlow to implement issue #123 in an isolated worktree and run full validation.
Use DevFlow to review PR #45 and fix any blocking issues.
```
## Commands And Workflows
| Command | Description |
|---------|-------------|
| `/devflow:devflow-setup` | Configure DevFlow for your project |
| `/devflow:feat` | Create feature specifications and GitHub issues |
| `/devflow:dev` | Implement features from GitHub issues |
| `/devflow:check` | Run parallel validations (tests, lint, types, build) |
| `/devflow:review-pr` | Perform comprehensive PR reviews |
| `/devflow:research` | Research topics before planning |
| `/devflow:epic` | Plan major initiatives with multiple phases |
## Repository Structure
```
devflow-skill/
├── .claude-plugin/
│ └── marketplace.json # Claude Code marketplace catalog
├── skills/
│ └── devflow/ # Canonical Agent Skill
│ ├── SKILL.md
│ ├── references/
│ └── assets/templates/
├── commands/ # Claude Code slash command wrappers
└── README.md
```
## Local Development
```bash
# Clone the repository
git clone https://github.com/docutray/devflow-skill
cd devflow-skill
# Agent Skills local test
npx skills add . --skill devflow
# Claude Code local marketplace test
/plugin marketplace add .
/plugin install devflow@local
```
Validate manifests:
```bash
jq empty .claude-plugin/marketplace.json
```
If available, validate the Agent Skill:
```bash
skills-ref validate ./skills/devflow
```
## References
- [Agent Skills specification](https://agentskills.io/specification)
- [skills.sh documentation](https://skills.sh/docs)
- [Claude Code plugins](https://docs.claude.com/en/docs/claude-code/plugins)
## License
MIT
## Support
- **Issues**: [GitHub Issues](https://github.com/docutray/devflow-skill/issues)
- **Contact**: Roberto Arce (roberto@docutray.com)