promote

Promote reusable patterns from downstream projects to the upstream agent-kit template.

2|1|Updated Jan 27, 2026

Search Tags:#automation #git #templates #pattern #pull-request #upstream #promote

Ready to run

npx skills add https://github.com/lucidlabs-hq/agent-kit --skill promote

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: promote
Source: https://github.com/lucidlabs-hq/agent-kit/tree/main/.claude/skills/promote
Command: npx skills add https://github.com/lucidlabs-hq/agent-kit --skill promote

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps downstream projects share reusable, pattern-based work with the upstream agent-kit, reducing duplication and ensuring consistency across templates.

Core Features & Use Cases

Promote .claude/skills/* and related artifacts from a downstream project to the upstream template to standardize patterns.
Enforce PR-based merging and upstream alignment to maintain code review discipline.
Document and track promoted items to improve maintainability and knowledge sharing.

Quick Start

Run the promote script to push reusable patterns from this project to the upstream agent-kit.

Frequently Asked Questions about promote

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

FAQPage Schema

How do I promote reusable patterns from a downstream project to an upstream template repository?▼

To promote reusable patterns from a downstream project to an upstream template, you run the promotion script to identify portable artifacts like UI components or CLI scripts, filter out domain-specific items, and push the changes via a feature branch and pull request.

What is the best way to share generic CLI scripts and documentation across multiple projects?▼

Sharing generic CLI scripts and documentation across projects is best handled by promoting them to a shared upstream agent-kit, which standardizes reusable patterns and reduces duplication through a reviewed pull request workflow.

How does the pull request workflow work when pushing reusable code upstream?▼

The pull request workflow for pushing reusable code upstream works by staging your generic patterns on a feature branch, filtering out project-specific logic, and submitting a PR to the upstream template to ensure code review discipline and alignment.

Should I include domain-specific components when standardizing patterns to an upstream agent-kit?▼

You should not include domain-specific components when standardizing patterns to an upstream agent-kit. The promotion process explicitly filters out project-specific items to ensure only generic, portable artifacts are shared across templates.

Can I use git feature branches to track promoted patterns back to the upstream template?▼

Yes, you can use git feature branches to track promoted patterns back to the upstream template. The process enforces PR-based merging and documents the promotion steps to improve maintainability and knowledge sharing.