ar-record-improvement

Record framework improvement suggestions as structured Markdown files in a shared improvements directory.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working in a project that uses the Agentic Repos framework, you often notice skill bugs, missing rules, or better patterns, but there is no consistent way to capture them. This Skill records those improvement suggestions as structured, deduplicated Markdown files in a shared improvements directory so they can be reviewed and applied later. ## Core Features & Use Cases - Structured capture: Guides you through describing the issue, auto-detecting a category (skill, agent, rule, setup, template), and assigning a priority (bug, should-fix, nice-to-have). - Dedup and contradiction gate: Scans the pending backlog before writing, enriches existing records on duplicates, and asks you to resolve contradictory proposals instead of silently dropping content. - Auto-commit and sequencing: Writes the file to the shared {ProjectName}_AgenticRepos/improvements/ directory, commits and pushes it to git, and regenerates an ORDER.md pick-up sequence for the backlog. - Use Case: While working in a backend service, you notice the PR skill fails on 403 rate limits. Run this Skill, describe the issue, and it saves a prioritized improvement file that the team applies later via ar-add-improvement. ## Quick Start Say "record improvement" and describe the framework issue or suggestion you noticed in the current project.

Frequently Asked Questions about ar-record-improvement

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

FAQPage Schema
How do I record an improvement suggestion for the Agentic Repos framework?▼

Say "record improvement" inside a target project that has .claude/config_hints.json. The Skill asks for a description, auto-detects the category and target, lets you set a priority, and writes a dated Markdown file to the shared improvements directory.

Where are recorded improvement files saved?▼

Improvement files are saved to {ProjectName}_AgenticRepos/improvements/, a directory derived from paths.tasks_root in .claude/skill.config. All platforms write to the same directory, with a platform frontmatter field distinguishing platform-specific items.

Does ar-record-improvement handle duplicate suggestions?▼

Yes. Before writing, it scans all pending items for semantic duplicates matching on target and topical overlap. Duplicates are merged into the existing canonical record as a dated update block rather than creating a new file.

What happens when a new improvement contradicts an existing one?▼

The Skill flags contradictory pending items and presents both to you to choose a preferred direction. The losing record is annotated with status superseded and a pointer to the winner, never silently deleted.

Why does ar-record-improvement fail with "Not an Agentic Repos project"?▼

That error means the current directory lacks .claude/config_hints.json, so it is not an initialized target project. Run the framework's init skill first, or move into a project that has been set up with Agentic Repos.

Does the Skill commit recorded improvements automatically?▼

Yes. After writing the file it resolves the owning git repo from the file's directory, stages only that file, commits, pulls with rebase, and pushes. If the directory is not under git, it saves locally and warns you to commit manually.