Skip to content

V0.8.1/agent smith - #33

Merged
gimlichael merged 7 commits into
mainfrom
v0.8.1/agent-smith
Aug 1, 2026
Merged

V0.8.1/agent smith#33
gimlichael merged 7 commits into
mainfrom
v0.8.1/agent-smith

Conversation

@gimlichael

Copy link
Copy Markdown
Member

This pull request updates the documentation for the agent-smith and git-visual-commits skills to clarify and expand their quality gates, skill authoring, and workflow requirements. The most important changes are summarized below.

Skill Workflow and Quality Gate Updates:

  • Updated the description of git-visual-commits to require a visible full-context quality gate for multi-file plans that initially collapse to one category, while single-file changes retain the fast path.
  • Added a new workflow rule: when more than one file initially appears to fit one category, the agent must visibly re-confirm the full skill read, full diff review, and per-file rationale before retaining that category; one-file changes keep the fast path.

Skill Authoring and Agent-Smith Enhancements:

  • Expanded the agent-smith description to explicitly include skill authoring, with new requirements for real execution, bounded-concurrency assessment, and reusable C#/.NET scripts and validators. Also references Agent Skills guidance for progressive disclosure, candidate evaluation, and human review.
  • Added to the agent-smith section that skill authoring maps independent retrieval, execution, validation, and grading for batching or bounded concurrency, favoring reusable C#/.NET scripts unless otherwise justified.
  • Documented that skill changes follow the Agent Skills lifecycle guidance for grounding, concise descriptions, realistic triggers, candidate-versus-baseline evaluation, grading, timing, aggregation, and human review.

These changes improve documentation clarity and enforce stricter, more transparent quality standards for skill workflows and authoring.

Restructured skill to emphasize concise communication and bounded-concurrency assessment for independent retrieval and validation work. Added skill-authoring reference with guidance on progressive disclosure, tool batching, script selection, candidate-versus-baseline evaluation, and real-task grounding for AI agents authoring skills.
Added validation rules to verify skill-authoring reference exists and contains required guidance on concise communication, parallelism assessment, progressive disclosure, and skill lifecycle. Expanded evals to test bounded-concurrency scenarios for independent endpoint retrieval.
Updated agent-smith skill summary to document new skill-authoring capabilities, concise-reporting guidelines, and bounded-concurrency assessment for independent operations. Added guidance on progressive disclosure pattern, faster skill workflows, and Agent Skills lifecycle for real-task grounding and baseline evaluation.
The commit workflow now requires a visible full-context audit when a multi-file change initially collapses into one category, so the plan stays explicit and the quality gate cannot be skipped by yolo or auto.
The template validator now checks for the new quality gate language in the skill, its evals, and the repo README so the documented contract remains enforced.
@gimlichael gimlichael self-assigned this Aug 1, 2026
@greptile-apps

greptile-apps Bot commented Aug 1, 2026

Copy link
Copy Markdown

Greptile Summary

The PR expands Agent Smith鈥檚 skill-authoring workflow and adds a visible quality gate for multi-file commit plans that initially collapse into one category.

  • Adds guidance for bounded concurrency, reusable C#/.NET validators, activation-description testing, baseline evaluation, grading, and human review.
  • Adds eval coverage and template assertions for the new authoring and commit-planning requirements.
  • Aligns README auto-approval wording with the existing requirement that yolo and auto only modify explicit commit requests.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
skills/agent-smith/SKILL.md Adds skill-authoring routing, concurrency and script-runtime requirements, and concise evidence-preserving response guidance.
skills/agent-smith/references/skill-authoring.md Introduces detailed guidance for evidence-grounded skill design, bounded concurrency, .NET-first tooling, activation descriptions, and comparative evaluation.
skills/agent-smith/evals/evals.json Adds an evaluation scenario covering concurrency, validator language choice, trigger quality, baseline comparison, and grading.
skills/git-visual-commits/SKILL.md Adds a visible full-context confirmation gate for multi-file plans provisionally assigned to one category.
skills/git-visual-commits/evals/evals.json Adds evaluation coverage for both the multi-file quality gate and its one-file fast-path exception.
scripts/validate-skill-templates.ps1 Extends repository validation assertions to cover the new Agent Smith and Git Visual Commits contracts.
README.md Documents the new workflows and clarifies that auto-approval tokens apply only within commit requests.

Reviews (2): Last reviewed commit: "馃挰 clarify auto-approval wording in read..." | Re-trigger Greptile

Comment thread skills/git-visual-commits/SKILL.md Outdated
The description now clarifies that yolo and auto are auto-approval modifiers only within an explicit commit request, never as standalone triggers for unrelated work. Added two new eval cases to enforce this contract: one verifies yolo in a non-commit context does not trigger the workflow, and another checks that auto in a formatter task does not cause unwanted commits. This tightens the triggering behavior and prevents accidental misuse.
Updated the auto-approval bullet point to explicitly state that yolo and auto should be used within a commit request, not as standalone modifiers. This clarification helps users understand the correct usage pattern and prevents confusion about when these keywords apply.
@gimlichael
gimlichael merged commit a9c7824 into main Aug 1, 2026
1 check passed
@gimlichael
gimlichael deleted the v0.8.1/agent-smith branch August 1, 2026 13:10
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