skills.rest
aaronjmars
aaronjmarsCOMMUNITY
Explore all skills by this author →
𝕏@aaronjmarsGitHub

strategy-builder

Drafts a STRATEGY.md north-star document from an operator's goal brief and repository context.

Updated Jun 11, 2026
Search Tags:#automation#strategy#prioritization#markdown generation#github workflow#north-star metric#goal parsing
One-click install
npx skills add https://github.com/aaronjmars/aeon-bd --skill strategy-builder-aaronjmars
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: strategy-builder
Source: https://github.com/aaronjmars/aeon-bd/tree/main/skills/strategy-builder
Command: npx skills add https://github.com/aaronjmars/aeon-bd --skill strategy-builder-aaronjmars

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Most repositories never tailor their STRATEGY.md, so automated skills run with no specific direction. This Skill turns a short goal brief plus existing repo context (README, memory, links) into a tight, actionable strategy file that guides every subsequent skill run. ## Core Features & Use Cases - Brief Parsing: Accepts structured dashboard input (repo=, links=, goal= tokens) or bare goal text, with fallback to repo README and memory when no brief is given. - Context Synthesis: Merges the operator's goal, current STRATEGY.md, repo README, MEMORY.md, and fetched links into a north-star metric, ordered priorities, audience, and hard constraints. - Refine-or-Replace Logic: Detects whether an existing strategy is customized and refines it instead of overwriting, keeping the prior version in git history. - Use Case: A maintainer clicks "Build my strategy" in the dashboard with the goal "grow paying teams, win on reliability"; the Skill reads the repo, drafts a sub-2000-character STRATEGY.md, commits it, sends a notification, and logs the run. ## Quick Start Run the strategy-builder skill with a goal like "grow active contributors to my open-source agent framework" to generate and commit a tailored STRATEGY.md.

Frequently Asked Questions about strategy-builder

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

FAQPage Schema
How do I generate a STRATEGY.md from a project goal?▼

Provide a goal as bare text or as structured tokens like repo=owner/repo, links=url, and goal=text. The Skill reads the brief plus your repo README and memory, then writes and commits a tailored STRATEGY.md with a north-star metric, priorities, audience, and constraints.

What input formats does the strategy brief accept?▼

The brief accepts two shapes: structured pipe-separated tokens (repo=, links=, goal=, with goal last) from the dashboard, or plain bare text containing just the goal. If the brief is empty, the Skill falls back to the repo README and memory/MEMORY.md.

Does it overwrite an existing customized STRATEGY.md?▼

No. If the current STRATEGY.md lacks the unconfigured-defaults marker, the Skill refines it—keeping what still holds and sharpening the rest. The previous version remains recoverable in git history.

What happens when no goal or repo context is available?▼

The Skill logs STRATEGY_BUILDER_SKIP with the reason and stops without writing anything or sending a notification. It never commits a generic placeholder strategy for an unconfigured fresh fork.

Why is there a character limit on STRATEGY.md?▼

STRATEGY.md is imported into CLAUDE.md and loaded into context on every skill run, so length is a recurring token cost. The Skill enforces a soft limit of about 2000 characters and trims priorities and prose before committing.

Can it read a private external repository for context?▼

It attempts to fetch external repo READMEs via gh api using the workflow's GITHUB_TOKEN. If the repo is private or returns 404, it falls back to the goal text and links, noting repo: unreadable in the log.

Related Skills

Explore More Product & Management Skills→
enunoenuno

strategy-builder

Construct strategy documents from repository metadata and user-defined goals.

Community
Advanced
viktorbezdekviktorbezdek
10

outcome-oriented-thinking

Convert product deliverables into measurable outcomes with leading and lagging metrics.

Community
Intermediate
user-no-founduser-no-found

plan-revision

Revise draft plans by evaluating analysis-agent review items and updating records.

Community
Advanced
upperspacecaseupperspacecase

product-marketing-context

Create and update a centralized product marketing context document.

Community
Intermediate