Skip to content

Add first-use guidance for Ghost - #316

Merged
awinther1 merged 4 commits into
mainfrom
codex/first-use-guidance
Nov 19, 2026
Merged

awinther1 merged 4 commits into
mainfrom
codex/first-use-guidance

Conversation

@awinther1

@awinther1 awinther1 commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator

Why

The installed Ghost skill explains the package, but it gives agents little help when a person asks what Ghost is or how to start. This change guides that first conversation.

What

  • Add a short explanation of Ghost and offer a starter .ghost/ package with a brand.md cover and starter guidance files.
  • Ask for broad brand material, such as brand positioning and content guidelines.
  • Guide the agent to a next step that fits the project.
  • Link to the guidance from the root README.

How

The skill tells the agent when to explain Ghost, how to respect the person's brand decisions, and whether to set up a package, adapt starter guidance, or apply existing guidance. It asks before drafting or changing files unless the person already asked for those changes, and asks the person to review and confirm guidance before saving it.

Risk

This changes documentation and the installed skill text. CLI behavior and package format stay the same.

Testing

The new copy gave shorter answers to general questions. In four setup tests, it avoided file writes that the old copy made before asking. The blind review was mixed: 10 pairs favored the new copy, 1 favored the old copy, and 13 tied. I would keep the change for clearer first answers and approval before setup writes.
Generated with Codex

awinther1 and others added 3 commits November 17, 2026 16:31
Co-authored-by: Nora <592adff51d2cf2bc270e2d3f34b2d47ac27a22a93f84fd4a054a5e54fcd993c1@buzz.block.builderlab.xyz>
Scope the short answer to definition-only questions and ask before setup writes. Keep the combined definition and setup path available.

Co-authored-by: Nora <592adff51d2cf2bc270e2d3f34b2d47ac27a22a93f84fd4a054a5e54fcd993c1@buzz.block.builderlab.xyz>
Co-authored-by: Nora <592adff51d2cf2bc270e2d3f34b2d47ac27a22a93f84fd4a054a5e54fcd993c1@buzz.block.builderlab.xyz>
@awinther1
awinther1 marked this pull request as ready for review November 18, 2026 22:39
nahiyankhan
nahiyankhan previously approved these changes Nov 18, 2026
@awinther1
awinther1 merged commit 8936dc5 into main Nov 19, 2026
6 checks passed
@awinther1
awinther1 deleted the codex/first-use-guidance branch November 19, 2026 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants