How do I install the Goal Synthesis skill?

Run npx skillmds@latest add majiayu000/goal-synthesis in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Goal Synthesis safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Goal Synthesis?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Goal Synthesis free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Goal Synthesis?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Goal Synthesis by majiayu000 — Agent Skill

Name: Goal Synthesis
Rating: 4.5 (4 reviews)
Author: majiayu000

Goal Synthesis

Use when user says "synthesize goals", "show goals", "what are my goals", "update goals", "show non-goals", "what am I building", "project direction", or asks about the overall direction or intent of the project - generates two markdown files summarizing the user's goals based on approved story nodes (what the goals ARE) and rejected story nodes with notes (what the non-goals ARE).

majiayu000 Updated Sep 9, 2026 567 repo stars

File contents

Goal Synthesis Skill

Generate goals.md and non-goals.md in .claude/data/goals/.

Workflow

Step 1: Check Prerequisites

python .claude/scripts/story_tree_helpers.py prereq

Exit early if:

needs_goals_update = false AND needs_non_goals_update = false (counts unchanged)
No story data (approved_count = 0 AND rejected_with_notes_count = 0)

Step 2: Spawn Parallel Agents

Launch agents for files that need updating (haiku model):

Agent 1 (goals) - Only if needs_goals_update is true:

Query: python .claude/scripts/story_tree_helpers.py approved
Read existing .claude/data/goals/goals.md for context (if exists)
Write .claude/data/goals/goals.md with sections: What We're Building, Target User, Core Capabilities, Guiding Principles, Footer with timestamp

Agent 2 (non-goals) - Only if needs_non_goals_update is true:

Query: python .claude/scripts/story_tree_helpers.py rejected
Read existing .claude/data/goals/non-goals.md for context (if exists)
Write .claude/data/goals/non-goals.md with sections: Explicit Exclusions (with rejection reasons), Anti-Patterns, YAGNI Items, Philosophical Boundaries, Footer with timestamp

Step 3: Update Metadata

After agents complete, update the synthesis metadata:

python .claude/scripts/story_tree_helpers.py update-meta

This records current counts so future prereq checks can skip synthesis when nothing has changed.

Key Rules

Spawn agents in parallel, never sequentially
Use Python sqlite3 module, NOT sqlite3 CLI
Include rejection reasons in non-goals bullets
Read existing files first to preserve accumulated context
Always run update-meta after successful synthesis

---name: goal-synthesisdescription: Use when user says "synthesize goals", "show goals", "what are my goals", "update goals", "show non-goals", "what am I building", "project direction", or asks about the overall direction or intent of the project - generates two markdown files summarizing the user's goals based on approved story nodes (what the goals ARE) and rejected story nodes with notes (what the non-goals ARE).--- # Goal Synthesis Skill Generate `goals.md` and `non-goals.md` in `.claude/data/goals/`. ## Workflow ### Step 1: Check Prerequisites ```bash python .claude/scripts/story_tree_helpers.py prereq ``` **Exit early if:** - `needs_goals_update` = false AND `needs_non_goals_update` = false (counts unchanged) - No story data (`approved_count` = 0 AND `rejected_with_notes_count` = 0) ### Step 2: Spawn Parallel Agents Launch agents for files that need updating (haiku model): **Agent 1 (goals)** - Only if `needs_goals_update` is true: - Query: `python .claude/scripts/story_tree_helpers.py approved` - Read existing `.claude/data/goals/goals.md` for context (if exists) - Write `.claude/data/goals/goals.md` with sections: What We're Building, Target User, Core Capabilities, Guiding Principles, Footer with timestamp **Agent 2 (non-goals)** - Only if `needs_non_goals_update` is true: - Query: `python .claude/scripts/story_tree_helpers.py rejected` - Read existing `.claude/data/goals/non-goals.md` for context (if exists) - Write `.claude/data/goals/non-goals.md` with sections: Explicit Exclusions (with rejection reasons), Anti-Patterns, YAGNI Items, Philosophical Boundaries, Footer with timestamp ### Step 3: Update Metadata After agents complete, update the synthesis metadata: ```bash python .claude/scripts/story_tree_helpers.py update-meta ``` This records current counts so future prereq checks can skip synthesis when nothing has changed. ## Key Rules - Spawn agents in parallel, never sequentially - Use Python sqlite3 module, NOT sqlite3 CLI - Include rejection reasons in non-goals bullets - Read existing files first to preserve accumulated context - Always run update-meta after successful synthesis

Frequently asked questions