promote

Promote project instincts to global scope via the instinct CLI.

7|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/Davie521/claude-skills --skill promote-davie521
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: promote
Source: https://github.com/Davie521/claude-skills/tree/main/plugins/skills/skills/promote
Command: npx skills add https://github.com/Davie521/claude-skills --skill promote-davie521

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Project-specific instincts are siloed within individual projects. This Skill promotes instincts from project scope to global scope, enabling reuse and standardization across multiple projects.

Core Features & Use Cases

  • Cross-project promotion: detect instincts that appear in multiple projects and elevate them to a global store with scope: global.
  • Local-to-global publishing: write promoted instincts to ~/.claude/homunculus/instincts/personal/ for cross-project reuse.
  • CLI-driven workflow: orchestrates promotion via the instinct CLI with optional --force and --dry-run flags.

Quick Start

Run the instinct CLI to promote an instinct from the current project to the global store.

Frequently Asked Questions about promote

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

FAQPage Schema
How do I promote project-specific instincts to a global scope for reuse?▼

To promote instincts to global scope, the Skill analyzes cross-project candidates and writes qualified instincts to ~/.claude/homunculus/instincts/personal/ with scope: global, enabling reuse across multiple projects. It uses the instinct CLI to orchestrate the promotion workflow.

What is the best way to share instincts across multiple projects?▼

Sharing instincts across projects is done by elevating them from project scope to a global store. The Skill detects cross-project candidates and publishes them to a personal global directory, standardizing behaviors so they apply wherever you work.

Can I preview which instincts will be promoted before making changes?▼

Yes, you can preview instinct promotion by running the instinct CLI with the --dry-run flag. This simulates the promotion process, showing which cross-project candidates qualify for global scope without writing any files to the personal instincts directory.

How do I overwrite existing global instincts during promotion?▼

To overwrite existing global instincts during promotion, use the --force flag with the instinct CLI. This forces the promotion workflow to replace instincts already stored in ~/.claude/homunculus/instincts/personal/ with the qualified cross-project candidates.

Do I need the instinct CLI installed to promote instincts to global scope?▼

Yes, promoting instincts to global scope requires the instinct CLI, accessed via the CLAUDE_PLUGIN_ROOT environment variable or a manual path. The CLI orchestrates the analysis of cross-project candidates and the subsequent writing of promoted instincts.

Why are my project instincts not applying to other projects automatically?▼

Project instincts remain siloed within individual projects by default. They must be explicitly promoted to global scope using the instinct CLI, which analyzes and writes qualified instincts to a personal global directory for cross-project reuse.