ar-add-improvement

Applies framework improvements with version bumping, CHANGELOG updates, and cross-file consistency validation.

1|2|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-add-improvement-mahsanamin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ar-add-improvement
Source: https://github.com/mahsanamin/agentic-repos/tree/main/.claude/commands/ar-add-improvement
Command: npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-add-improvement-mahsanamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Framework improvements, bug fixes, and workflow refinements accumulate across projects but get applied inconsistently, without version tracking, changelog entries, or contradiction checks, leaving a shared multi-team framework incoherent and untraceable. ## Core Features & Use Cases - Improvement Intake: Import improvements from other projects, apply free-form descriptions, or review recorded improvements from a shared inbox with delete-on-apply semantics. - Contradiction & Ordering Checks: Verifies selected improvements are mutually consistent and applies them in dependency order from ORDER.md before editing any framework file. - Version & Documentation Management: Determines patch/minor/major bumps per VERSIONING.md rules, then updates config_hints.json, CLAUDE.md, and CHANGELOG.md with consistency validation. - Use Case: After recording several improvements from a backend project, run this skill to review the pending inbox, apply them to the correct rule tiers, bump the framework version, and open a PR with a complete CHANGELOG entry. ## Quick Start Ask the assistant to run ar-add-improvement to review the recorded improvements inbox and bump the framework version.

Frequently Asked Questions about ar-add-improvement

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an improvement to the Agentic Repos framework?▼

Invoke ar-add-improvement and choose one of three intake paths: import from another project, describe changes in free-form text, or review recorded improvements from the shared improvements inbox. The skill applies changes, bumps the version, and updates the CHANGELOG.

How does the skill decide between patch, minor, and major version bumps?▼

It reads VERSIONING.md rules: patch for bug fixes and wording, minor for new skills or significant enhancements, and major for breaking changes or structural reorganization. It reads the current version from config_hints.json and proposes the next version for your approval.

What happens to recorded improvement files after they are applied?▼

Applied improvement files are deleted from the shared improvements inbox using git rm when tracked, falling back to plain rm otherwise. The content is preserved in the framework CHANGELOG and the workspace repo's git history.

Does ar-add-improvement check for contradictory improvements before applying them?▼

Yes, it performs a contradiction check before editing any framework file, reading all selected improvements plus the open PR. On conflict it stops, surfaces both sides, and asks which wins before reconciling and applying.

What validation runs before the version bump is committed?▼

It runs generic-skill-lint and project-noise-lint scripts to catch stack-idiom leaks and project-specific noise, verifies version numbers match across config_hints.json, CLAUDE.md, and CHANGELOG.md, and requires skill-creator evals when skills or agents changed.