@votruongdanh/ai-agent-skills 3.3.2 → 3.3.4

package/skills/status/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: status
+description: "Project status summary, progress snapshots, repo overview, and outstanding work tracking. Use when the user wants to know where a project stands. Triggers: status, progress, overview, what's done, dự án đang ở đâu, tiến độ, tổng quan."
+agents: [project-planner, orchestrator]
+related-skills: [plan, debug, deploy]
+---
+
+## Memory Protocol
+**START**: Read `.ai-memory.md` from project root. This is the PRIMARY source for status — check all recorded history, decisions, tasks, bugs, and milestones.
+**END**: Update `.ai-memory.md` using **Memory Compaction Rules** with: status snapshot, what's working, gaps, risks, and priorities.
+
+## Goal
+Summarize where things stand right now, leveraging the memory file for deep context.
+
+## Agent Routing
+- For project health overview → read `.kiro/skills/agents/agents/project-planner.md` and apply its knowledge
+- For multi-workstream status → read `.kiro/skills/agents/agents/orchestrator.md` and apply its knowledge
+- For technical debt assessment → read the relevant specialist agent file based on domain
+
+## Workflow
+1. **Read Memory** — Load `.ai-memory.md` as the primary context source.
+2. Inspect the repository, relevant files, and any recent context from the chat.
+3. Summarize what already exists.
+4. Identify gaps, risks, TODOs, and likely next priorities.
+5. Present a concise health/status view.
+6. **Update Memory** — Save current status snapshot to `.ai-memory.md`.
+
+## Output format
+- Current state (from memory + repo scan)
+- What is working
+- What is incomplete
+- Risks or blockers
+- Recent changes (from memory)
+- Recommended next step
+
+## Checklist
+- [ ] Memory file read for historical context
+- [ ] Repository scanned for current state
+- [ ] Working features identified
+- [ ] Gaps and incomplete items listed
+- [ ] Risks or blockers flagged
+- [ ] Next priority recommended
+- [ ] Memory file updated with status snapshot
+
+- [ ] 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
+- Be specific and evidence-based.
+- Separate facts from inference.
+- Do not recommend broad refactors without confirming scope; ASK if the fix would touch many areas.
+- Always read and update the memory file.
+
+## Quality Gate
+After completing, read `.kiro/skills/_scripts/verify-all.md` for full project verification checklist.
+
+## Related Skills
+- `/plan` → read `.kiro/skills/plan/SKILL.md` — Create plan for incomplete items
+- `/debug` → read `.kiro/skills/debug/SKILL.md` — Investigate flagged risks
+- `/deploy` → read `.kiro/skills/deploy/SKILL.md` — Deploy when ready

package/skills/test/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: test
+description: "Write tests, improve coverage, define test strategy, and add validation. Use when the user wants to test code, add unit/integration/e2e tests, or check coverage. Triggers: test, coverage, jest, vitest, playwright, spec, kiểm thử, viết test."
+agents: [test-engineer, debugger]
+related-skills: [debug, create, enhance]
+---
+
+## Memory Protocol
+**START**: Read `.ai-memory.md` from project root. Check test framework in use, existing test coverage, known failing tests, testing patterns, and CI/CD test configuration.
+**END**: Update `.ai-memory.md` using **Memory Compaction Rules** with: tests changed, coverage deltas (if known), patterns established, and gaps.
+
+## Goal
+Improve confidence in the system through targeted testing.
+
+## Agent Routing
+- Primary → read `.kiro/skills/agents/agents/test-engineer.md` and apply its knowledge
+- If testing reveals bugs → read `.kiro/skills/agents/agents/debugger.md` and apply its knowledge
+- For E2E/integration tests with UI → read `.kiro/skills/agents/agents/frontend-specialist.md` and apply its knowledge
+- For API/backend tests → read `.kiro/skills/agents/agents/backend-specialist.md` and apply its knowledge
+- For security testing → read `.kiro/skills/agents/agents/security-auditor.md` and apply its knowledge
+
+## Socratic Gate
+Before writing tests, verify:
+1. What is the test scope? (unit, integration, E2E, API?)
+2. Does a test framework already exist in the project?
+3. What are the critical paths that must be tested?
+If any answer is unclear, ASK before proceeding.
+
+## Workflow
+1. **Read Memory** — Load `.ai-memory.md` for testing history and patterns.
+2. Identify the unit, integration, API, UI, or regression scope.
+3. Enumerate critical paths, edge cases, and failure modes.
+4. Add or propose tests that cover the most important risks first.
+5. Explain how to run the tests and what passing means.
+6. **Quality Gate** — Read `.kiro/skills/_scripts/checklist.md` and run test suite after writing tests.
+7. **Update Memory** — Save test details and coverage notes to `.ai-memory.md`.
+
+## Checklist
+- [ ] Test scope identified
+- [ ] Test framework confirmed/proposed
+- [ ] Critical paths covered
+- [ ] Edge cases included
+- [ ] Failure modes tested
+- [ ] Tests are stable (not brittle)
+- [ ] Run instructions provided
+- [ ] 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
+- Prefer stable tests over brittle tests.
+- Cover both happy path and key edge cases.
+- If no test framework exists, propose the lightest practical option.
+- Avoid changing unrelated production code; if tests require refactors, ASK before widening scope.
+- Always read and update the memory file.
+
+## Related Skills
+- `/debug` → read `.kiro/skills/debug/SKILL.md` — Fix failing tests or bugs found
+- `/create` → read `.kiro/skills/create/SKILL.md` — Create test fixtures or helpers
+- `/enhance` → read `.kiro/skills/enhance/SKILL.md` — Improve test quality and coverage

package/skills/ui-ux-pro-max/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: ui-ux-pro-max
+description: "Advanced UI/UX improvements — layout, design critique, copy refinement, interaction design, accessibility, and responsive patterns. Use when the user wants professional-grade UI/UX upgrades. Triggers: ui, ux, design, layout, responsive, giao diện, thiết kế, cải thiện UI."
+agents: [frontend-specialist, performance-optimizer]
+related-skills: [create, preview, enhance]
+---
+
+## Memory Protocol
+**START**: Read `.ai-memory.md` from project root. Check design system, brand guidelines, component library, past UI decisions, accessibility notes, and responsive design patterns.
+**END**: Update `.ai-memory.md` using **Memory Compaction Rules** with: UI/UX changes, patterns used, a11y improvements, and brand consistency notes.
+
+## Goal
+Upgrade the product experience with clear, practical UI/UX improvements.
+
+## Agent Routing
+- Primary → read `.kiro/skills/agents/agents/frontend-specialist.md` and apply its knowledge
+- For performance of UI (load time, animations) → read `.kiro/skills/agents/agents/performance-optimizer.md` and apply its knowledge
+- For accessibility compliance → apply WCAG knowledge from frontend-specialist
+- For mobile responsiveness → apply mobile patterns from frontend-specialist
+
+## Socratic Gate
+Before improving UI/UX, verify:
+1. What screen, flow, or component is being improved?
+2. What is the current pain point? (visual, usability, accessibility, performance?)
+3. Are there existing design guidelines or component library?
+If any answer is unclear, ASK before proceeding.
+
+## Workflow
+1. **Read Memory** — Load `.ai-memory.md` for design history and UI patterns.
+2. Identify the screen, flow, or component being improved.
+3. Evaluate hierarchy, spacing, clarity, accessibility, states, feedback, and conversion friction.
+4. Recommend concrete improvements with rationale.
+5. When asked to implement, favor polished but maintainable UI.
+6. **Quality Gate** — Read `.kiro/skills/_scripts/checklist.md` and verify all states and accessibility.
+7. **Update Memory** — Save UI/UX decisions and patterns to `.ai-memory.md`.
+
+## Output format
+- UX issues found
+- Visual issues found
+- Recommended changes (prioritized)
+- Accessibility notes (WCAG compliance)
+- Implementation priorities
+- Component states covered (empty, loading, error, success)
+
+## Checklist
+- [ ] Target screen/component identified
+- [ ] Hierarchy and spacing evaluated
+- [ ] Accessibility checked (WCAG)
+- [ ] All states covered (empty, loading, error, success)
+- [ ] Mobile responsiveness considered
+- [ ] Performance impact assessed
+- [ ] Brand consistency maintained
+- [ ] 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
+- Optimize for clarity before decoration.
+- Respect existing brand and component patterns when present.
+- Include empty, loading, error, and success states when relevant.
+- Avoid widespread redesigns unless asked; prioritize small, safe diffs and ASK before large UI rewrites.
+- Always read and update the memory file.
+
+## Related Skills
+- `/create` → read `.kiro/skills/create/SKILL.md` — Implement UI components
+- `/preview` → read `.kiro/skills/preview/SKILL.md` — Preview design before implementation
+- `/enhance` → read `.kiro/skills/enhance/SKILL.md` — Improve existing UI code