Skip to content

V0.8.2/patch behaviour - #34

Merged
gimlichael merged 8 commits into
mainfrom
v0.8.2/patch-behaviour
Aug 7, 2026
Merged

V0.8.2/patch behaviour#34
gimlichael merged 8 commits into
mainfrom
v0.8.2/patch-behaviour

Conversation

@gimlichael

Copy link
Copy Markdown
Member

This pull request is a patch release (v0.8.2) focused on skill refinement and documentation updates, with an emphasis on deprecating skill-creator-agnostic in favor of Anthropic's skill-creator, expanding and clarifying documentation for several skills, and improving repository guidance. The most important changes include deprecation notices and removal of skill-creator-agnostic from recommendations, major workflow and documentation enhancements for git-keep-a-changelog, and improved guidance for other skills.

Skill Deprecation and Documentation Updates

  • skill-creator-agnostic is now explicitly deprecated, no longer maintained, and scheduled for removal in 1.0.0. All documentation (including README.md and AGENTS.md) now directs users to use Anthropic's skill-creator with repository-specific rules instead. It is removed from recommended install lists and its SKILL.md is now a deprecation shim. [1] [2] [3] [4] [5] [6]

Skill Workflow and Guidance Improvements

  • git-keep-a-changelog: Expanded with step-by-step workflow sections, a deterministic reduction model for semantic-delta analysis, mandatory release highlight contract, checkpoint enforcement, and improved documentation of good/bad output characteristics and user-intent gates. SKILL.md is refactored to include these changes.
  • git-nuget-release-notes and git-visual-squash-summary: Documentation and eval coverage are enhanced, including improved guidance on workflow, history reduction, and semantic grouping. [1] [2] [3]

Repository Guidance and Third-party Skills Policy

  • AGENTS.md is updated to clarify that third-party skills (like Anthropic's skill-creator) must not be modified or wrapped with overlays; repo-specific behavior should be documented only in AGENTS.md.

Changelog and Versioning

  • CHANGELOG.md is updated with detailed entries for v0.8.2 and v0.8.1, including all major documentation, workflow, and deprecation changes. Compare links for the new versions are added. [1] [2]

Skill Validation Tooling

  • Skill validation scripts are enhanced to better check skill content, structure, and consistency, with new eval coverage for validation behavior.

These changes ensure that users follow up-to-date, reliable workflows, avoid deprecated tools, and have clear, enforced guidance for skill authoring and repository management.

skill-creator-agnostic is no longer maintained and scheduled for removal in 1.0.0. This skill has been superseded by Anthropic's skill-creator with repository-level governance rules documented in AGENTS.md. Update repo documentation and mark skill as deprecated shim.
Refactor skill instructions and update eval definitions to enhance clarity and maintainability of the changelog generation workflow.
Refactor skill instructions and update eval definitions to enhance clarity and maintainability of the per-package release notes workflow.
Refactor skill instructions and update eval definitions to enhance clarity and maintainability of the squash-summary workflow.
Add deterministic validator for skill structure, frontmatter, and file organization. Ensures consistent skill repository conventions and compliance with AGENTS.md requirements.
Update repository README to reflect skill changes, deprecations, and recent improvements. Maintain accurate documentation of available skills and their status.
Document breaking changes, new features, improvements, and deprecations in this release. Reflects skill enhancements, governance updates, and deprecation of skill-creator-agnostic.
@gimlichael gimlichael self-assigned this Aug 7, 2026
@greptile-apps

greptile-apps Bot commented Aug 7, 2026

Copy link
Copy Markdown

Greptile Summary

This patch release refines several Git-oriented skills, deprecates skill-creator-agnostic, strengthens skill validation and evaluation guidance, and updates repository documentation and release history.

  • Adds cumulative semantic-delta workflows and expanded eval coverage for changelog, NuGet release-note, and squash-summary skills.
  • Redirects skill authors to Anthropic's skill-creator with repository-specific guidance in AGENTS.md.
  • Documents releases 0.8.1 and 0.8.2 and updates their comparison links.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
AGENTS.md Adds the deprecation policy and clarifies that repository-specific rules must not be implemented as third-party skill overlays.
CHANGELOG.md Adds the 0.8.1 and 0.8.2 release entries and comparison links; the intentionally omitted Unreleased link requires no action.
scripts/validate-skill-templates.ps1 Extends deterministic validation for the revised skill content and structure contracts without an eligible follow-up defect.
skills/git-keep-a-changelog/SKILL.md Refactors changelog generation around explicit scope resolution, cumulative-delta analysis, confirmation gates, and completion checkpoints.
skills/git-nuget-release-notes/SKILL.md Prioritizes surviving package-level deltas over intermediate history when generating release notes.
skills/git-visual-squash-summary/SKILL.md Changes summary reduction to describe only semantic outcomes surviving from the resolved base to HEAD.
skills/skill-creator-agnostic/SKILL.md Replaces the former workflow with a compatibility deprecation shim directing users to Anthropic's skill-creator.

Reviews (2): Last reviewed commit: "📝 remove unreleased changelog compare l..." | Re-trigger Greptile

Comment thread CHANGELOG.md
@gimlichael
gimlichael merged commit 6df7de1 into main Aug 7, 2026
1 check passed
@gimlichael
gimlichael deleted the v0.8.2/patch-behaviour branch August 7, 2026 16:43
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