propose-improvement

Analyze workflow improvement ideas, calculate ROI, and create GitHub Issues.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/takemo101/compose-workflow --skill propose-improvement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propose-improvement
Source: https://github.com/takemo101/compose-workflow/tree/main/.pi/skills/propose-improvement
Command: npx skills add https://github.com/takemo101/compose-workflow --skill propose-improvement

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill transforms raw ideas and observations about workflow inefficiencies into well-defined, actionable GitHub Issues, complete with ROI analysis and implementation plans.

Core Features & Use Cases

  • Idea to Issue Lifecycle: Manages the entire process from initial theme input to a created GitHub Issue.
  • ROI Analysis: Quantifies the potential benefits of proposed improvements.
  • Structured Proposal Generation: Creates formal proposal documents for review and approval.
  • Use Case: You notice a repetitive manual step in your team's development process. Use this Skill to analyze the inefficiency, propose a solution with estimated time savings, and generate a GitHub Issue for implementation.

Quick Start

Initiate a workflow improvement proposal for the theme 'reduce build times'.

Frequently Asked Questions about propose-improvement

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

FAQPage Schema
How do I turn workflow improvement ideas into actionable GitHub Issues?

To turn workflow improvement ideas into GitHub Issues, this Skill automates initial idea analysis, calculates ROI, drafts structured proposals, and creates the issues using specific templates and commands.

Can I generate a proposal with ROI analysis for developer productivity enhancements?

Yes, you can generate a proposal with ROI analysis for developer productivity enhancements by inputting a theme; the Skill quantifies potential benefits and structures the formal proposal document for review.

Do I need the GitHub CLI installed to automate proposal generation for process improvements?

Yes, you need the GitHub CLI (gh) installed and configured in your environment to automate the final issue creation step for process improvement proposals.

What is the best way to draft structured proposals for workflow automation inefficiencies?

The best way to draft structured proposals for workflow automation inefficiencies is using this Skill to guide you through input analysis, existing proposal checks, and formal drafting before final issue creation.

How does the process check for existing proposals before creating a new GitHub Issue?

The process checks for existing proposals during the analysis phase by reviewing current GitHub Issues, ensuring new workflow improvement suggestions do not duplicate previous efforts before drafting a new proposal.

Are there limitations when automating ROI calculation for GitHub Issues?

A limitation of automating ROI calculation for GitHub Issues is that the quantified benefits rely entirely on the accuracy of the initial theme input provided by the user during the analysis phase.