template-upstream

Generate structured improvement proposals for upstream Python templates.

14|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/tae0y/python-project-template --skill template-upstream
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: template-upstream
Source: https://github.com/tae0y/python-project-template/tree/main/.claude/skills/template-upstream
Command: npx skills add https://github.com/tae0y/python-project-template --skill template-upstream

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose structured improvements from a concrete project back to the upstream template by generating proposal artifacts in proposals/.

Core Features & Use Cases

  • Generate a draft proposal file under proposals/draft/YYYYMMDD/proposal-<slug>.md with required metadata and content structure.
  • Enforce template-wide sharing of patterns by consolidating proposals in a single proposals directory for review and inclusion.
  • Provide a reusable workflow to document, categorize, and review changes before upstream integration.

Quick Start

Run this skill from the template repository and create a draft proposal under proposals/draft/YYYYMMDD.

Frequently Asked Questions about template-upstream

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

FAQPage Schema
How do I propose upstream template changes from a current Python project?

To propose upstream template changes, generate a structured proposal artifact under the proposals/draft/YYYYMMDD directory. This consolidates project-specific patterns, rules, and configurations into a standardized format for upstream review and inclusion.

What is an upstream proposal workflow for sharing project configurations?

An upstream proposal workflow documents and categorizes project patterns worth sharing with a template repository. It enforces template-wide consistency by generating draft proposals in a centralized proposals directory before integration.

When should I create a draft proposal for an upstream Python template?

Create a draft proposal when patterns, hooks, rules, or configurations from your current project are valuable enough to share with the upstream Python template to improve consistency across multiple projects.

What metadata format is required for an upstream template proposal file?

An upstream template proposal file requires specific metadata including the source project, category, and status. The file must be generated in the target directory proposals/draft/YYYYMMDD with a proposal-<slug>.md naming convention.

Can I use this workflow to document project rules before upstream integration?

Yes, this workflow provides a reusable process to document, categorize, and review project rules and configurations before integrating them into the upstream Python template. It generates structured proposal artifacts for systematic review.

Are there limitations to consolidating proposals in a single proposals directory?

Consolidating proposals in a single directory enforces structured review but requires manual categorization and status tracking. The workflow generates draft proposals under proposals/draft/YYYYMMDD, meaning final upstream inclusion depends on separate review processes.