Add goose-blog-post skill#11

Merged

angiejones merged 14 commits intomainfrom

add-goose-blog-post-skill

Feb 10, 2026

Collaborator

angiejones commented Feb 10, 2026 •

edited

Loading

Summary

Adds a new goose-blog-post skill that guides AI agents through writing and publishing blog posts for the block/goose open-source project.

What This Skill Does

Provides a step-by-step workflow for creating blog posts on the goose Docusaurus blog:

Gather blog post details — topic, author, audience, key points
Verify/create author entry — checks authors.yml and scaffolds new entries
Create the blog post directory — correct YYYY-MM-DD-slug-title/ naming convention
Write the blog post — frontmatter, banner image, truncate marker, content with goose-specific conventions
Social media image setup — Open Graph / Twitter card metadata
Review checklist — validates all conventions are followed
Local preview instructions — tells the user how to preview (without blocking the terminal)

Conventions Encoded

Frontmatter format (title, description, authors)
Banner image requirements (1200×600, placed after frontmatter)
 marker placement
Heading hierarchy (no h1 in body)
goose-specific linking and naming conventions
authors.yml entry format with GitHub avatar URL derivation

Checklist

Skill follows the Agent Skills specification
SKILL.md includes required frontmatter (name, description)
No secrets, API keys, or sensitive data
Skill is broadly useful for anyone contributing to the goose blog
Includes a complete example blog post for reference


          Add goose-blog-post skill

c47d733

A skill that guides agents through writing and publishing blog posts
for the block/goose open-source project. Includes step-by-step workflow
for author setup, directory creation, frontmatter, content writing with
goose-specific conventions, and a review checklist.

github-actions bot commented Feb 10, 2026 •

edited

Loading

✅ Validate Skills — PASSED

Summary: FAIL=0 · WARN=0
Changed skill dirs: goose-blog-post

Output (last 200 lines)

✅ Found 7 skill directories.
✅ api-setup: structure validated
✅ beads: structure validated
✅ code-review: structure validated
✅ frontend-design: structure validated
✅ goose-blog-post: structure validated
✅ rp-why: structure validated
✅ testing-strategy: structure validated

Structure validation PASSED.

github-actions bot commented Feb 10, 2026 •

edited

Loading

🛡️ Skills Security Scan — WARN

Summary: FAIL=0 · WARN=30 · FILES=3
Changed skills scanned: goose-blog-post

⚠️ WARN requires investigation + CODEOWNERS review.

⚠️ Warnings

goose-blog-post

network:url — goose-blog-post/README.md:3

A skill that guides AI agents through writing and publishing blog posts for the [block/goose](https://github.com/block/goose) open source project.

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/README.md:8

npx skills add https://github.com/block/agent-skills --skill goose-blog-post

Guidance: Review: URL present; confirm expected destination and purpose.

content:entropy-high-file — goose-blog-post/SKILL.md:1

---

network:url — goose-blog-post/SKILL.md:16

Write blog posts for the [block/goose](https://github.com/block/goose) open source project blog powered by Docusaurus.

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:69

  image_url: https://avatars.githubusercontent.com/u/<github-id>?v=4

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:77

Ask the user for any missing details (name, title, GitHub username, social handles). The `image_url` can be derived from their GitHub profile: `https://avatars.githubusercontent.com/u/<id>?v=4`. Look up their GitHub user ID if needed:

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:180

- When linking to goose docs: `https://block.github.io/goose/`

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:181

- When linking to the repo: `https://github.com/block/goose`

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:182

- When linking to extensions: `https://block.github.io/goose/extensions`

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:192

  <meta property="og:url" content="https://block.github.io/goose/blog/YYYY/MM/DD/slug-title" />

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:194

  <meta property="og:image" content="https://block.github.io/goose/assets/images/BANNER_FILENAME_WITH_HASH.png" />

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:199

  <meta name="twitter:image" content="https://block.github.io/goose/assets/images/BANNER_FILENAME_WITH_HASH.png" />

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:208

- `og:url` — the production URL: `https://block.github.io/goose/blog/YYYY/MM/DD/slug-title`

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:213

When first creating the post, use `https://block.github.io/goose/assets/images/BANNER_FILENAME_WITH_HASH.png` as the placeholder for `og:image` and `twitter:image`. The `BANNER_FILENAME_WITH_HASH` portion will be replaced with the real file…

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:228

This starts a local dev server at `http://localhost:3000` with hot reloading.

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:234

   `http://localhost:3000/goose/assets/images/banner-a1b2c3d4e5f6.png`

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:237

   `https://block.github.io/goose/assets/images/banner-a1b2c3d4e5f6.png`

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:320

Building an MCP server took about an hour and saved our team countless context switches. If you want to learn more, check out the [MCP documentation](https://modelcontextprotocol.io/introduction) and the [goose extensions directory](https:/…

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:325

  <meta property="og:url" content="https://block.github.io/goose/blog/2025/07/01/custom-mcp-server" />

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:327

  <meta property="og:image" content="https://block.github.io/goose/assets/images/banner-a1b2c3d4e5f6.png" />

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/SKILL.md:332

  <meta name="twitter:image" content="https://block.github.io/goose/assets/images/banner-a1b2c3d4e5f6.png" />

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/references/BLOG-POST-TEMPLATE.md:36

  <meta property="og:url" content="https://block.github.io/goose/blog/YYYY/MM/DD/slug-title" />

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/references/BLOG-POST-TEMPLATE.md:38

  <meta property="og:image" content="https://block.github.io/goose/assets/images/FILENAME_FROM_PREVIEW" />

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/references/BLOG-POST-TEMPLATE.md:43

  <meta name="twitter:image" content="https://block.github.io/goose/assets/images/FILENAME_FROM_PREVIEW" />

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/references/BLOG-POST-TEMPLATE.md:55

  image_url: https://avatars.githubusercontent.com/u/GITHUB_USER_ID?v=4

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/references/BLOG-POST-TEMPLATE.md:88

- goose docs: https://block.github.io/goose/

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/references/BLOG-POST-TEMPLATE.md:89

- goose repo: https://github.com/block/goose

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/references/BLOG-POST-TEMPLATE.md:90

- Extensions directory: https://block.github.io/goose/extensions

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/references/BLOG-POST-TEMPLATE.md:91

- MCP docs: https://modelcontextprotocol.io/introduction

Guidance: Review: URL present; confirm expected destination and purpose.

network:url — goose-blog-post/references/BLOG-POST-TEMPLATE.md:99

5. Production URL: `https://block.github.io/goose/assets/images/<filename>`

Guidance: Review: URL present; confirm expected destination and purpose.

Notes: This comment auto-updates on each push to keep PRs clean.

github-actions bot added the security-review-required label


          Refactor skill to support three writing modes

d2c86f8

Authors often want to write their own content rather than have the agent
write everything. The skill now supports three modes:

1. 'I have a draft' — agent scaffolds and reviews, preserves author voice
2. 'I have notes/an outline' — agent expands into draft, author reviews
3. 'Write it for me' — agent writes full post, author reviews

Also adds a mandatory 'present draft for review' step and moves content
type suggestions into their own reference section.

github-actions bot added security-review-required and removed security-review-required labels


          Add blog post template reference file

b90ce35

Includes a quick-start template, author entry template, frontmatter
quick reference table, directory naming convention, and key URLs.
This supports progressive disclosure — the agent loads the main SKILL.md
first and can pull in this reference for scaffolding details.

github-actions bot added security-review-required and removed security-review-required labels


          lowercase g

bc38d58

github-actions bot added security-review-required and removed security-review-required labels


          Add required <head> section with OG/Twitter meta tags

3be8812

- Banner image is now the social sharing image (no separate social-banner)
- Every post must end with a <head> section for Open Graph and Twitter cards
- Added Step 6: Preview locally to discover the Docusaurus-hashed image URL
- Updated template reference to include <head> section and image URL discovery
- Reordered steps: preview is now required (not optional) since it's needed
  to get the image URL for the social metadata

github-actions bot added security-review-required and removed security-review-required labels


          Clarify image URL placeholders to always show production base URL

a22f5f5

- Template placeholder now shows full production URL with just the filename
  as the variable part: https://block.github.io/goose/assets/images/FILENAME
- Ensures agents never paste localhost URLs into the <head> section
- Consistent between SKILL.md and BLOG-POST-TEMPLATE.md

github-actions bot removed the security-review-required label

angiejones commented

View reviewed changes

goose-blog-post/SKILL.md Outdated Show resolved Hide resolved


          Apply suggestion from @angiejones

0e0aef8

github-actions bot added the security-review-required label

angiejones commented

View reviewed changes

goose-blog-post/SKILL.md Outdated Show resolved Hide resolved

github-actions bot removed the security-review-required label


          Apply suggestion from @angiejones

6eeb0fc

github-actions bot added security-review-required and removed security-review-required labels

angiejones requested review from blackgirlbytes and Copilot

February 10, 2026 18:09

Copilot started reviewing on behalf of angiejones

February 10, 2026 18:10

Copilot AI reviewed

View reviewed changes

Contributor

Copilot AI left a comment

Pull request overview

Adds a new goose-blog-post Agent Skill that provides a structured workflow (with templates) for drafting and publishing blog posts to the block/goose Docusaurus blog.

Changes:

Introduces goose-blog-post/SKILL.md with an end-to-end, step-by-step blog authoring/publishing workflow.
Adds goose-blog-post/references/BLOG-POST-TEMPLATE.md as a reusable post + author-entry template.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File	Description
goose-blog-post/SKILL.md	Defines the guided workflow, conventions, preview steps, and an example post.
goose-blog-post/references/BLOG-POST-TEMPLATE.md	Provides a starter `index.md` template and `authors.yml` entry scaffold.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

goose-blog-post/SKILL.md Show resolved Hide resolved

goose-blog-post/SKILL.md Outdated Show resolved Hide resolved

goose-blog-post/SKILL.md Show resolved Hide resolved

goose-blog-post/references/BLOG-POST-TEMPLATE.md Show resolved Hide resolved

EbonyLouis previously approved these changes

View reviewed changes


          Fix nested code fences in example section

75061d7

Use 4-backtick outer fence so inner ```bash code blocks render
correctly instead of showing literal backslash escapes.

Resolves Copilot review comment.

angiejones dismissed EbonyLouis’s stale review via

75061d7

February 10, 2026 18:45

github-actions bot added security-review-required and removed security-review-required labels

angiejones requested a review from Copilot

February 10, 2026 18:46

Copilot started reviewing on behalf of angiejones

February 10, 2026 18:46


          Add README with install command and summary

d781804

github-actions bot added security-review-required and removed security-review-required labels

angiejones commented

View reviewed changes

goose-blog-post/README.md Outdated Show resolved Hide resolved


          Apply suggestion from @angiejones

d0f8215

angiejones commented

View reviewed changes

goose-blog-post/SKILL.md Outdated Show resolved Hide resolved

angiejones commented

View reviewed changes

goose-blog-post/SKILL.md Outdated Show resolved Hide resolved

github-actions bot removed the security-review-required label


          Apply suggestions from code review

b5f871e

github-actions bot added security-review-required and removed security-review-required labels

angiejones enabled auto-merge

February 10, 2026 18:50

Copilot AI reviewed

View reviewed changes

Contributor

Copilot AI left a comment

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

goose-blog-post/SKILL.md Outdated Show resolved Hide resolved

goose-blog-post/references/BLOG-POST-TEMPLATE.md Outdated Show resolved Hide resolved

github-actions bot added the security-review-required label


          Update goose-blog-post/references/BLOG-POST-TEMPLATE.md

6e6341d

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

github-actions bot removed the security-review-required label


          Apply suggestion from @Copilot

0f08fc9

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

github-actions bot added security-review-required and removed security-review-required labels

EbonyLouis approved these changes

View reviewed changes

angiejones merged commit 60bfdad into main

4 checks passed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

security-review-required