Skip to content

Skill make blog post - #3724

Merged
aaronpowell merged 22 commits into
github:mainfrom
jhauga:skill-make-blog-post
Oct 7, 2026
Merged

aaronpowell merged 22 commits into
github:mainfrom
jhauga:skill-make-blog-post

Conversation

@jhauga

@jhauga jhauga commented Sep 24, 2026

Copy link
Copy Markdown
Contributor

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution adds a new instruction, prompt, agent, skill, workflow, or canvas extension file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.
  • I am targeting the main branch for this pull request.

Description

Skill to assist in the automation, or help in making blog post for a workspace, repo, or as a standalone post.

Porting instructions from PR 3584 to skill.


Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • New canvas extension.
  • Update to existing instruction, prompt, agent, plugin, skill, workflow, or canvas extension.
  • Other (please specify):

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

jhauga and others added 13 commits September 21, 2026 18:37
Updated post file layout and clarified approval process for posting.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Clarified automation mode description and updated linking instructions for documentation.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Clarify instructions for handling destination paths and conflicts.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Clarified instructions for handling drafts and file naming rules.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Clarified the closing condition for the gate in staged mode.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Clarified instructions for writing and uploading blog posts, including changes to venue-specific copy handling and slug conventions.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings September 24, 2026 03:26
@jhauga
jhauga requested a review from aaronpowell as a code owner September 24, 2026 03:26
@github-actions github-actions Bot added new-submission PR adds at least one new contribution skills PR touches skills labels Sep 24, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🔒 PR Risk Scan Results

Scanned 6 changed file(s).

Severity Count
🔴 High 0
🟠 Medium 0
ℹ️ Info 0

✅ No matching risk patterns were detected in changed files.

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

@jhauga jhauga mentioned this pull request Sep 24, 2026
9 of 17 tasks
@github-actions

Copy link
Copy Markdown
Contributor

🔍 Vally Lint Results

✅ All checks passed

Scope Checked
Skills 1
Agents 0
Total 1
Severity Count
❌ Errors 0
⚠️ Warnings 0
ℹ️ Advisories 0

Summary

Level Finding
ℹ️ ✅ make-blog-post (2/2 checks passed)
ℹ️ ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
ℹ️ ✓ spec-compliance: All spec checks passed.
ℹ️ ✓ [valid-refs] All file references across 1 skill(s) are valid.
ℹ️ ✓ valid-refs: All file references resolve to existing files within the skill directory.
ℹ️ 1 skill(s) linted, 1 passed
Full linter output
### Linting skills/make-blog-post
✅ make-blog-post (2/2 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.

1 skill(s) linted, 1 passed

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

External samples need prompt-injection safeguards, and the Jekyll and voice-reuse guidance contains conflicting or inaccurate instructions.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 High severity · 2 Medium severity

Open (3)
What changed in this PR

Adds a reusable skill for drafting code-focused blog posts with approval gates, author-voice matching, and destination-aware formatting.

Changes:

  • Adds the blog-post drafting workflow and voice-profile template.
  • Documents platform, delivery, SEO, and voice-matching guidance.
  • Registers the skill in the generated catalog.
File Description
skills/​make-blog-post/​SKILL.md Defines the skill workflow and safeguards.
skills/​make-blog-post/​references/​voice-profile.md Guides author-voice analysis.
skills/​make-blog-post/​references/​seo.md Defines destination-specific SEO rules.
skills/​make-blog-post/​references/​delivery.md Defines delivery formats and boundaries.
skills/​make-blog-post/​references/​blog-platforms.md Documents generator-specific conventions.
skills/​make-blog-post/​assets/​voice-profile-template.md Provides a reusable voice profile.
docs/​README.skills.md Adds the skill to the catalog.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread skills/make-blog-post/references/voice-profile.md Outdated
Comment thread skills/make-blog-post/references/blog-platforms.md Outdated
Comment thread skills/make-blog-post/references/voice-profile.md Outdated
Updated guidelines for voice profile and blog platforms.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings September 24, 2026 03:33

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Invalid YAML and unresolved metadata and privacy conflicts could prevent correct or safe skill operation.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 High severity

Open (1)
Resolved since last review (3)
Previously missed (2)

In code that hasn't changed since last review

Medium severity Prevent persistence of private URLs and local paths

skills/​make-blog-post/​assets/​voice-profile-template.md:10

The skill recommends saving this profile in the blog repository, but these placeholders allow private URLs and absolute local paths to be persisted there. That can expose usernames, machine paths, or private source locations when the repository is published; constrain saved references to public URLs or safe repository-relative paths.

Medium severity Require author identity confirmation before voice filtering

skills/​make-blog-post/​references/​voice-profile.md:19

On a multi-author site, filtering by an author field still requires knowing which author belongs to the user. Without a request/profile value, this can silently learn and reproduce another contributor's voice; require confirmation instead of inferring identity.

Comment thread skills/make-blog-post/SKILL.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings September 24, 2026 03:37

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Conflicting front-matter guidance, incomplete sample handling, and potentially sensitive saved paths need correction.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 High severity

Open (1)
Resolved since last review (1)
Previously missed (2)

In code that hasn't changed since last review

Medium severity Handle all cases with fewer than three samples

skills/​make-blog-post/​SKILL.md:52

This only handles the zero-sample case, but the workflow requires three to five samples and the reference says fewer than three gives a thin read (references/voice-profile.md:7). With one or two posts available, the skill neither asks for enough additional samples nor discloses that the match is limited. Handle every <3 case explicitly so a thin profile is not presented as a full voice match.

Medium severity Avoid raw front matter for non-parsing destinations

skills/​make-blog-post/​SKILL.md:119

“No front matter contract” also includes Gists, Discussions, hosted editors, and other destinations that do not parse front matter. This fallback therefore conflicts with references/delivery.md:11-19, which says those targets must not receive raw front matter. Limit this template to destinations that actually parse YAML so venue output cannot expose metadata as body text.

Comment thread skills/make-blog-post/assets/voice-profile-template.md Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

The skill is coherent, differentiated, correctly registered, and has no unresolved review findings.

Review effort: Balanced
Findings: None

@github-actions

github-actions Bot commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

🚦 Submission status: ⏳ Awaiting automation

Risk tier: merge-risk:medium — New or substantially changed resource without privileged execution
Required to merge: passing submission-gate checks plus 1 approval from reviewers with write access.

Why this tier
  • Adds 6 file(s), e.g. skills/make-blog-post/SKILL.md
  • Changes 455 lines (low-risk limit is 40)

Automated checks

Check Status Details
Line endings ✅ Passed Passed · logs
Spelling ✅ Passed Passed · logs
Generated README consistency ✅ Passed Passed · logs
Skill validation ✅ Passed Passed · logs
Skill lint (vally) ✅ Passed Passed · logs
Risk scan ✅ Passed Passed · logs
Contributor reputation ✅ Passed Passed · logs
Duplicate resource scan ✅ Passed Passed · logs
PR quality signal ⏭️ Skipped Skipped by its workflow · logs
Contributor risk signal 🔧 Infrastructure failure The contributor check succeeded but its result artifact was missing, unreadable, or for another commit · logs

Action needed

  • 🔧 Contributor risk signal hit an automation problem that is not caused by your contribution. Comment /rerun-checks to retry; maintainers are notified if it keeps failing.

Review

  • Approvals: 0/1
  • Assigned reviewer: aaronpowell
  • Review target date: not set
  • Still needed: 1 more approval(s)
  • No staffed reviewer pool owns these files yet; any reviewer with write access counts as the domain reviewer.

Commands

Command Who What it does
/rerun-checks PR author, maintainers Re-runs failed or incomplete checks and re-evaluates this gate
/request-review PR author, maintainers Asks the review rotation to assign a reviewer (adds needs-reviewer)

Updated for 96d3472 · gate run · This comment is maintained automatically — see submission gate docs.

Copilot AI balanced review requested due to automatic review settings October 2, 2026 03:38
@jhauga
jhauga requested review from a team as code owners October 2, 2026 03:38
@github-actions github-actions Bot added ready-for-review Submission passed intake validation and is ready for maintainer review and removed awaiting-automation labels Oct 2, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Remote repository destinations need an explicit local-checkout fallback to avoid an invalid or unintended delivery path.

Review effort: Balanced
Findings: 1 Medium severity

Open (1)

Comment thread skills/make-blog-post/SKILL.md Outdated
Clarify instructions on handling user-specified destinations and workspace paths.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings October 2, 2026 03:42
@github-actions github-actions Bot added awaiting-automation and removed ready-for-review Submission passed intake validation and is ready for maintainer review labels Oct 2, 2026
@github-actions github-actions Bot added ready-for-review Submission passed intake validation and is ready for maintainer review and removed awaiting-automation labels Oct 2, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

The skill is complete, correctly registered, internally consistent, and has no unresolved review findings.

Review effort: Balanced
Findings: None

Resolved since last review (1)

@github-actions github-actions Bot added awaiting-automation ready-for-review Submission passed intake validation and is ready for maintainer review and removed ready-for-review Submission passed intake validation and is ready for maintainer review awaiting-automation labels Oct 2, 2026
@aaronpowell
aaronpowell merged commit 8f45917 into github:main Oct 7, 2026
25 of 27 checks passed
@jhauga
jhauga deleted the skill-make-blog-post branch October 7, 2026 20:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting-automation merge-risk:medium new-submission PR adds at least one new contribution skills PR touches skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants