Agent skill
aget-provide-feedback
Provide structured feedback with severity classification
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/aget-provide-feedback
SKILL.md
aget-provide-feedback
Provide structured feedback with severity classification. Balances constructive criticism with positive observations.
Instructions
When this skill is invoked:
-
Review Work Product
- Understand context and goals
- Identify what was attempted
- Note constraints author faced
-
Classify Feedback
- Blocking: Must fix, prevents acceptance
- Suggestion: Should consider, improves quality
- Nitpick: Minor, stylistic
- Praise: Positive, worth acknowledging
-
Make Actionable
- Specific location
- Clear description
- Suggested resolution
-
Balance
- Include positive observations
- Constructive tone
- Proportionate to significance
Output Format
## Feedback: [Work Product]
### Summary
| Severity | Count |
|----------|-------|
| Blocking | [N] |
| Suggestion | [N] |
| Nitpick | [N] |
| Praise | [N] |
---
### Blocking Issues
1. **[Location]**
- Issue: [Description]
- Impact: [Why this blocks]
- Suggestion: [How to resolve]
---
### Suggestions
1. **[Location]**
- Observation: [What could be better]
- Rationale: [Why it matters]
- Suggestion: [Specific improvement]
---
### Nitpicks
1. **[Location]**: [Minor observation]
---
### Positive Observations
1. **[Location]**: [What was done well]
2. **General**: [Overall strength]
---
### Overall Assessment
[Brief summary of quality level and key points]
Severity Guidelines
| Severity | Criteria | Examples |
|---|---|---|
| Blocking | Prevents functionality, correctness, or compliance | Bug, security issue, spec violation |
| Suggestion | Improves quality, maintainability, clarity | Refactoring opportunity, better naming |
| Nitpick | Style, preference, minor | Formatting, comment wording |
| Praise | Notable positive | Elegant solution, thorough testing |
Constraints
- C1: NEVER classify all feedback as blocking — severity inflation reduces effectiveness
- C2: NEVER provide vague feedback — specific feedback enables action
- C3: NEVER use harsh or personal language — constructive tone maintains collaboration
Related
- SKILL-032: aget-provide-feedback specification
- ONTOLOGY_reviewer.yaml: Feedback, Issue, Approval concepts
- CAP-REV-002: Feedback Delivery capability
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?