agentleFS
VoTruongDanhVoTruongDanh/Skills-Agent/.cursor/skills/enhance/SKILL.md

enhance

Skill4 starsChanged 33 days agoMITView on GitHub

Improve existing code — refactor, optimize performance, tighten security, or enhance UX. Use when the user wants to make code better without changing its purpose. Triggers: enhance, improve, refactor, optimize, review, cải thiện, tối ưu, nhanh hơn, code dài quá.

We split this skill into the rules it gives an agent

13 rules. 0 are common, 5 are distinctive, and 8 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 8

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    START: Read .ai-memory.md from project root.

    line 10
  2. Very specific:

    END: Update .ai-memory.md using Memory Compaction Rules with: what changed, impact, tradeoffs, and remaining tech debt.

    line 11
  3. Very specific:

    If enhancing performance → read .kiro/skills/agents/agents/performance-optimizer.md and apply its knowledge

    line 17
  4. Very specific:

    If tightening security → read .kiro/skills/agents/agents/security-auditor.md and apply its knowledge

    line 18
  5. Very specific:

    If improving UI/UX → read .kiro/skills/agents/agents/frontend-specialist.md and apply its knowledge

    line 19
  6. Very specific:

    If refactoring backend/API → read .kiro/skills/agents/agents/backend-specialist.md and apply its knowledge

    line 20
  7. Very specific:

    If improving database queries → read .kiro/skills/agents/agents/database-architect.md and apply its knowledge

    line 21
  8. Distinctive:

    If any answer is unclear, ASK before proceeding.

    line 28
  9. Distinctive:

    Prefer small, meaningful upgrades over broad rewrites.

    line 54
  10. Distinctive:

    If performance is discussed, explain where the gain comes from.

    line 55
  11. Distinctive:

    Avoid changing unrelated files.

    line 56
  12. Distinctive:

    Always read and update the memory file.

    line 57
  13. Very specific:

    All code snippets and example files referenced or produced by this skill must be UTF-8 encoded.

    line 65

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Memory Protocol

START: Read .ai-memory.md from project root. Check past enhancements, known pain points, tech debt notes, performance baselines, and architecture decisions. END: Update .ai-memory.md using Memory Compaction Rules with: what changed, impact, tradeoffs, and remaining tech debt.

Goal

Improve an existing implementation without breaking working behavior.

Agent Routing

  • If enhancing performance → read .kiro/skills/agents/agents/performance-optimizer.md and apply its knowledge
  • If tightening security → read .kiro/skills/agents/agents/security-auditor.md and apply its knowledge
  • If improving UI/UX → read .kiro/skills/agents/agents/frontend-specialist.md and apply its knowledge
  • If refactoring backend/API → read .kiro/skills/agents/agents/backend-specialist.md and apply its knowledge
  • If improving database queries → read .kiro/skills/agents/agents/database-architect.md and apply its knowledge

Socratic Gate

Before enhancing, verify:

  1. What specific aspect needs improvement? (performance, security, UX, maintainability?)
  2. What is the current pain point or metric?
  3. Are there existing tests that must continue to pass? If any answer is unclear, ASK before proceeding.

Workflow

  1. Read Memory — Load .ai-memory.md for project context and past enhancement history.
  2. Understand the current state and pain points.
  3. Identify high-impact improvements in quality, maintainability, performance, reliability, or UX.
  4. Prioritize improvements by value versus effort.
  5. Implement or recommend the top changes.
  6. Explain tradeoffs and validation steps.
  7. Quality Gate — Read .kiro/skills/_scripts/checklist.md and verify enhancements don't break existing behavior.
  8. Update Memory — Save enhancement details and outcomes to .ai-memory.md.

Checklist

  • Current state documented
  • Pain points identified
  • Improvements prioritized by value/effort
  • Existing behavior preserved
  • Tradeoffs explained
  • Tests still passing
  • Memory file updated
  • Clean code chuẩn (Standard clean code applied)
  • Cập nhật đầy đủ tất cả các file liên quan (All related files fully updated)

Rules

  • Preserve behavior unless the user asked for a behavior change.
  • Prefer small, meaningful upgrades over broad rewrites.
  • If performance is discussed, explain where the gain comes from.
  • Avoid changing unrelated files; if improvement requires broad refactor, ASK before doing it.
  • Always read and update the memory file.

Related Skills

  • /debug → read .kiro/skills/debug/SKILL.md — Fix issues found during enhancement
  • /test → read .kiro/skills/test/SKILL.md — Verify enhancements don't break things
  • /plan → read .kiro/skills/plan/SKILL.md — Plan large-scale refactoring

Encoding

All code snippets and example files referenced or produced by this skill must be UTF-8 encoded. When applicable, include encoding: "UTF-8" in SKILL.md front-matter and ensure saved files use UTF-8 (no BOM).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.