@votruongdanh/ai-agent-skills 3.4.0 → 3.4.1

package/.agents/.skills-version

@@ -1 +1 @@
-3.3.4
+3.4.0

package/.agents/skills/agents/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: agents
 description: "Agent routing system — automatically selects the best specialist agent based on user request domain. Handles keyword matching, Vietnamese and English triggers, compound-keyword routing, vague-request fallback, and multi-agent coordination. This skill is always loaded silently."
+encoding: "UTF-8"
 metadata:
   category: system
   auto-load: true

package/.agents/skills/brainstorm/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: brainstorm
 description: "Ideation, option generation, and feature exploration. Use when the user wants to brainstorm ideas, explore options, compare approaches, or generate creative solutions. Triggers: brainstorm, ideate, options, ý tưởng, so sánh phương án."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [plan, create, orchestrate]
 ---

package/.agents/skills/clean/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: clean
 description: "Clean up junk files, temporary files, AI-generated artifacts, and caches. Use when the user wants to remove unused files, reduce repo clutter, or update .gitignore. Triggers: clean, remove junk, dọn dẹp, xoá file rác, cache."
+encoding: "UTF-8"
 agents: [devops-engineer]
 related-skills: [status, enhance]
 ---

package/.agents/skills/create/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: create
 description: "Build new features, files, components, endpoints, pages, or scripts. Use when the user wants to create something new in the codebase. Triggers: create, build, add, new, scaffold, tạo, thêm mới, tạo trang, tạo API."
+encoding: "UTF-8"
 agents: [backend-specialist, frontend-specialist, database-architect]
 related-skills: [plan, test, debug]
 ---

package/.agents/skills/debug/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: debug
 description: "Root-cause analysis for bugs, failing commands, broken behavior, and error logs. Use when the user encounters errors, crashes, or unexpected behavior. Triggers: debug, fix, bug, error, crash, lỗi, sửa lỗi, hỏng, fail."
+encoding: "UTF-8"
 agents: [debugger, backend-specialist, frontend-specialist]
 related-skills: [test, enhance, status]
 ---

package/.agents/skills/deploy/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: deploy
 description: "Deployment steps, release preparation, environment setup, CI/CD guidance, and production rollout. Use when the user wants to deploy, release, or set up infrastructure. Triggers: deploy, release, CI/CD, docker, production, triển khai, phát hành, đưa lên production."
+encoding: "UTF-8"
 agents: [devops-engineer, security-auditor]
 related-skills: [test, status, plan]
 ---

package/.agents/skills/enhance/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: enhance
 description: "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á."
+encoding: "UTF-8"
 agents: [performance-optimizer, security-auditor, frontend-specialist]
 related-skills: [debug, test, plan]
 ---

package/.agents/skills/explain/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: explain
 description: "Explain code, walk through logic, and help understand architecture or behavior. Use when the user asks what code does, how something works, or wants a walkthrough. Triggers: explain, what does this do, how does this work, giải thích, giải thích code, code này làm gì."
+encoding: "UTF-8"
 agents: [documentation-writer, backend-specialist, frontend-specialist]
 related-skills: [debug, enhance, status]
 ---
@@ -65,6 +66,7 @@ If any answer is unclear, ASK before proceeding.
 - If the code is unclear or has issues, mention them without derailing the explanation.
 - Avoid proposing wide changes mid-explanation; if improvement requires broader edits, ASK before switching to implementation.
 - Always read and update the memory file.
+ - Code encoding: All code snippets and files referenced or produced must be UTF-8 encoded. When providing example files, ensure they use UTF-8 and indicate `encoding: "UTF-8"` in front-matter where applicable.
 
 ## Related Skills
 - `/debug` → read `.kiro/skills/debug/SKILL.md` — If explanation reveals bugs

package/.agents/skills/integrate/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: integrate
 description: "Integrate provided sample code/snippets into the existing system with minimal changes and minimal risk. Use when the user gives a code mẫu and wants to merge it into current project. Triggers: integrate, merge snippet, gộp code mẫu, ghép code, áp code mẫu vào hệ thống."
+encoding: "UTF-8"
 agents: [backend-specialist, frontend-specialist, debugger]
 related-skills: [plan, test, debug, enhance]
 ---

package/.agents/skills/motion-ui/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: motion-ui
 description: "Advanced Motion UI (AMUI) — Create clean, modern UI with subtle Framer Motion micro-interactions, clear states (idle/loading/success/error), consistent styling via design tokens, and smooth animations. Use when the user wants motion-rich, polished UI with micro-interactions. Triggers: motion, animation, framer motion, micro-interaction, smooth ui, amui, chuyển động, hiệu ứng mượt."
+encoding: "UTF-8"
 agents: [frontend-specialist]
 related-skills: [create, ui-ux-pro-max, enhance]
 ---

package/.agents/skills/orchestrate/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: orchestrate
 description: "Coordinate multi-step plans across multiple roles, files, systems, or parallel workstreams. Use when the user has a complex request spanning multiple domains or needing decomposition. Triggers: orchestrate, coordinate, multi-step, full-stack, tổng hợp, làm nhiều bước."
+encoding: "UTF-8"
 agents: [orchestrator, project-planner]
 related-skills: [plan, create, deploy, test]
 ---

package/.agents/skills/plan/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: plan
 description: "Create concrete implementation plans with milestones, task breakdowns, and estimates. Use when the user wants to plan, organize work, or create a roadmap. Triggers: plan, milestone, breakdown, roadmap, estimate, kế hoạch, lên kế hoạch, phân chia công việc."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [brainstorm, create, orchestrate]
 ---

package/.agents/skills/preview/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: preview
 description: "Preview expected output, UX flows, copy, interaction design, or generated content before implementing. Use when the user wants to see what something will look like. Triggers: preview, mockup, show me, xem trước, thử xem, mô phỏng."
+encoding: "UTF-8"
 agents: [frontend-specialist, documentation-writer]
 related-skills: [create, ui-ux-pro-max, plan]
 ---

package/.agents/skills/status/SKILL.md

@@ -1,6 +1,7 @@
 ---
 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."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [plan, debug, deploy]
 ---

package/.agents/skills/test/SKILL.md

@@ -1,6 +1,7 @@
 ---
 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."
+encoding: "UTF-8"
 agents: [test-engineer, debugger]
 related-skills: [debug, create, enhance]
 ---

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

@@ -1,6 +1,7 @@
 ---
 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."
+encoding: "UTF-8"
 agents: [frontend-specialist, performance-optimizer]
 related-skills: [create, preview, enhance]
 ---

package/.kiro/.skills-version

@@ -1 +1 @@
-3.3.4
+3.4.0

package/.kiro/skills/agents/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: agents
 description: "Agent routing system — automatically selects the best specialist agent based on user request domain. Handles keyword matching, Vietnamese and English triggers, compound-keyword routing, vague-request fallback, and multi-agent coordination. This skill is always loaded silently."
+encoding: "UTF-8"
 metadata:
   category: system
   auto-load: true

package/.kiro/skills/brainstorm/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: brainstorm
 description: "Ideation, option generation, and feature exploration. Use when the user wants to brainstorm ideas, explore options, compare approaches, or generate creative solutions. Triggers: brainstorm, ideate, options, ý tưởng, so sánh phương án."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [plan, create, orchestrate]
 ---

package/.kiro/skills/clean/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: clean
 description: "Clean up junk files, temporary files, AI-generated artifacts, and caches. Use when the user wants to remove unused files, reduce repo clutter, or update .gitignore. Triggers: clean, remove junk, dọn dẹp, xoá file rác, cache."
+encoding: "UTF-8"
 agents: [devops-engineer]
 related-skills: [status, enhance]
 ---

package/.kiro/skills/create/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: create
 description: "Build new features, files, components, endpoints, pages, or scripts. Use when the user wants to create something new in the codebase. Triggers: create, build, add, new, scaffold, tạo, thêm mới, tạo trang, tạo API."
+encoding: "UTF-8"
 agents: [backend-specialist, frontend-specialist, database-architect]
 related-skills: [plan, test, debug]
 ---

package/.kiro/skills/debug/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: debug
 description: "Root-cause analysis for bugs, failing commands, broken behavior, and error logs. Use when the user encounters errors, crashes, or unexpected behavior. Triggers: debug, fix, bug, error, crash, lỗi, sửa lỗi, hỏng, fail."
+encoding: "UTF-8"
 agents: [debugger, backend-specialist, frontend-specialist]
 related-skills: [test, enhance, status]
 ---

package/.kiro/skills/deploy/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: deploy
 description: "Deployment steps, release preparation, environment setup, CI/CD guidance, and production rollout. Use when the user wants to deploy, release, or set up infrastructure. Triggers: deploy, release, CI/CD, docker, production, triển khai, phát hành, đưa lên production."
+encoding: "UTF-8"
 agents: [devops-engineer, security-auditor]
 related-skills: [test, status, plan]
 ---

package/.kiro/skills/enhance/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: enhance
 description: "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á."
+encoding: "UTF-8"
 agents: [performance-optimizer, security-auditor, frontend-specialist]
 related-skills: [debug, test, plan]
 ---

package/.kiro/skills/explain/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: explain
 description: "Explain code, walk through logic, and help understand architecture or behavior. Use when the user asks what code does, how something works, or wants a walkthrough. Triggers: explain, what does this do, how does this work, giải thích, giải thích code, code này làm gì."
+encoding: "UTF-8"
 agents: [documentation-writer, backend-specialist, frontend-specialist]
 related-skills: [debug, enhance, status]
 ---
@@ -65,6 +66,7 @@ If any answer is unclear, ASK before proceeding.
 - If the code is unclear or has issues, mention them without derailing the explanation.
 - Avoid proposing wide changes mid-explanation; if improvement requires broader edits, ASK before switching to implementation.
 - Always read and update the memory file.
+ - Code encoding: All code snippets and files referenced or produced must be UTF-8 encoded. When providing example files, ensure they use UTF-8 and indicate `encoding: "UTF-8"` in front-matter where applicable.
 
 ## Related Skills
 - `/debug` → read `.kiro/skills/debug/SKILL.md` — If explanation reveals bugs

package/.kiro/skills/integrate/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: integrate
 description: "Integrate provided sample code/snippets into the existing system with minimal changes and minimal risk. Use when the user gives a code mẫu and wants to merge it into current project. Triggers: integrate, merge snippet, gộp code mẫu, ghép code, áp code mẫu vào hệ thống."
+encoding: "UTF-8"
 agents: [backend-specialist, frontend-specialist, debugger]
 related-skills: [plan, test, debug, enhance]
 ---

package/.kiro/skills/motion-ui/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: motion-ui
 description: "Advanced Motion UI (AMUI) — Create clean, modern UI with subtle Framer Motion micro-interactions, clear states (idle/loading/success/error), consistent styling via design tokens, and smooth animations. Use when the user wants motion-rich, polished UI with micro-interactions. Triggers: motion, animation, framer motion, micro-interaction, smooth ui, amui, chuyển động, hiệu ứng mượt."
+encoding: "UTF-8"
 agents: [frontend-specialist]
 related-skills: [create, ui-ux-pro-max, enhance]
 ---

package/.kiro/skills/orchestrate/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: orchestrate
 description: "Coordinate multi-step plans across multiple roles, files, systems, or parallel workstreams. Use when the user has a complex request spanning multiple domains or needing decomposition. Triggers: orchestrate, coordinate, multi-step, full-stack, tổng hợp, làm nhiều bước."
+encoding: "UTF-8"
 agents: [orchestrator, project-planner]
 related-skills: [plan, create, deploy, test]
 ---

package/.kiro/skills/plan/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: plan
 description: "Create concrete implementation plans with milestones, task breakdowns, and estimates. Use when the user wants to plan, organize work, or create a roadmap. Triggers: plan, milestone, breakdown, roadmap, estimate, kế hoạch, lên kế hoạch, phân chia công việc."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [brainstorm, create, orchestrate]
 ---

package/.kiro/skills/preview/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: preview
 description: "Preview expected output, UX flows, copy, interaction design, or generated content before implementing. Use when the user wants to see what something will look like. Triggers: preview, mockup, show me, xem trước, thử xem, mô phỏng."
+encoding: "UTF-8"
 agents: [frontend-specialist, documentation-writer]
 related-skills: [create, ui-ux-pro-max, plan]
 ---

package/.kiro/skills/status/SKILL.md

@@ -1,6 +1,7 @@
 ---
 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."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [plan, debug, deploy]
 ---

package/.kiro/skills/test/SKILL.md

@@ -1,6 +1,7 @@
 ---
 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."
+encoding: "UTF-8"
 agents: [test-engineer, debugger]
 related-skills: [debug, create, enhance]
 ---

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

@@ -1,6 +1,7 @@
 ---
 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."
+encoding: "UTF-8"
 agents: [frontend-specialist, performance-optimizer]
 related-skills: [create, preview, enhance]
 ---

package/lib/skill-bundle.js

@@ -415,6 +415,7 @@ function renderSkillFile(skill, format) {
     const lines = [
       '---',
       `description: ${toYamlString(skill.description)}`,
+      `encoding: "UTF-8"`,
     ];
     if (skill.agents && skill.agents.length) {
       lines.push(`agents: [${skill.agents.join(', ')}]`);
@@ -427,6 +428,7 @@ function renderSkillFile(skill, format) {
     const lines = [
       '---',
       `description: ${toYamlString(skill.description)}`,
+      `encoding: "UTF-8"`,
     ];
     if (skill.agents && skill.agents.length) {
       lines.push(`agents: [${skill.agents.join(', ')}]`);
@@ -438,6 +440,21 @@ function renderSkillFile(skill, format) {
   throw new Error(`Unsupported skill format: ${format}`);
 }
 
+function ensureEncodingInFile(filePath) {
+  try {
+    const text = fs.readFileSync(filePath, 'utf8');
+    const parsed = parseFrontmatter(text);
+    if (!parsed.frontmatter.encoding) {
+      parsed.frontmatter.encoding = 'UTF-8';
+      const fm = yaml.stringify(parsed.frontmatter).trim();
+      const newContent = ['---', fm, '---', '', parsed.body, ''].join('\n');
+      fs.writeFileSync(filePath, newContent, 'utf8');
+    }
+  } catch (err) {
+    // If the file is missing frontmatter or can't be parsed, skip silently
+  }
+}
+
 function buildGeneratedTargetWarnings(skill, format, targetDir) {
   if (format === 'skill' || !skill.assetDirectories.length) {
     return [];
@@ -461,9 +478,13 @@ function writeSkillTarget(skill, targetDir, format) {
   ensureDirectory(targetDir);
 
   if (format === 'skill') {
-    copyDirectory(skill.skillDir, path.join(targetDir, skill.slug));
+    const destDir = path.join(targetDir, skill.slug);
+    copyDirectory(skill.skillDir, destDir);
+    // Ensure the copied SKILL.md includes an encoding field
+    const copiedSkillFile = path.join(destDir, 'SKILL.md');
+    ensureEncodingInFile(copiedSkillFile);
     return {
-      outputPath: path.join(targetDir, skill.slug, 'SKILL.md'),
+      outputPath: copiedSkillFile,
       warnings: [],
     };
   }
@@ -609,6 +630,8 @@ function installBundle(options) {
             'autoRun: true',
             '---',
             '',
+            `Canonical source: .kiro/skills/instructions.md`,
+            '',
             body,
             '',
           ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@votruongdanh/ai-agent-skills",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "description": "Cross-IDE AI agent skills with native installers for Kiro, Cursor, Windsurf, Claude Code, Antigravity, and VS Code/Copilot",
   "main": "index.js",
   "bin": {

package/scripts/check_workflows.js

@@ -0,0 +1,17 @@
+const fs = require('fs');
+const path = require('path');
+const workflowDir = path.join(__dirname, '..', '.agent', 'workflows');
+if (!fs.existsSync(workflowDir)) {
+  console.error('Workflow dir missing');
+  process.exit(2);
+}
+const files = fs.readdirSync(workflowDir).filter(f => f.endsWith('.md'));
+let ok = true;
+for (const f of files) {
+  const p = path.join(workflowDir, f);
+  const content = fs.readFileSync(p, 'utf8');
+  const has = content.includes('Canonical source');
+  console.log(f + ': ' + (has ? 'OK' : 'MISSING'));
+  if (!has) ok = false;
+}
+process.exit(ok ? 0 : 1);

package/skills/agents/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: agents
 description: "Agent routing system — automatically selects the best specialist agent based on user request domain. Handles keyword matching, Vietnamese and English triggers, compound-keyword routing, vague-request fallback, and multi-agent coordination. This skill is always loaded silently."
+encoding: "UTF-8"
 metadata:
   category: system
   auto-load: true
@@ -81,6 +82,9 @@ For complex requests that span domains:
 ## Quality Gate
 After completing any routed task, read `.kiro/skills/_scripts/checklist.md` for cross-cutting quality checks.
 
+## 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).
+
 ## Rules
 - Agent selection is SILENT — do not ask the user which agent to use
 - Always announce which agent is being applied

package/skills/brainstorm/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: brainstorm
 description: "Ideation, option generation, and feature exploration. Use when the user wants to brainstorm ideas, explore options, compare approaches, or generate creative solutions. Triggers: brainstorm, ideate, options, ý tưởng, so sánh phương án."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [plan, create, orchestrate]
 ---
@@ -63,6 +64,9 @@ If any answer is unclear, ASK before proceeding.
 ## Quality Gate
 After completing, read `.kiro/skills/_scripts/checklist.md` for cross-cutting quality checks.
 
+## 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).
+
 ## Related Skills
 - `/plan` → read `.kiro/skills/plan/SKILL.md` — Turn chosen option into actionable plan
 - `/create` → read `.kiro/skills/create/SKILL.md` — Implement the chosen option

package/skills/clean/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: clean
 description: "Clean up junk files, temporary files, AI-generated artifacts, and caches. Use when the user wants to remove unused files, reduce repo clutter, or update .gitignore. Triggers: clean, remove junk, dọn dẹp, xoá file rác, cache."
+encoding: "UTF-8"
 agents: [devops-engineer]
 related-skills: [status, enhance]
 ---
@@ -79,6 +80,9 @@ Proceed with deletion? (y/n)
 ## Quality Gate
 After completing, read `.kiro/skills/_scripts/checklist.md` for cross-cutting quality checks.
 
+## 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).
+
 ## Follow-up Actions
 - Update .gitignore to prevent future junk accumulation
 - Suggest cleanup scripts for recurring patterns

package/skills/create/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: create
 description: "Build new features, files, components, endpoints, pages, or scripts. Use when the user wants to create something new in the codebase. Triggers: create, build, add, new, scaffold, tạo, thêm mới, tạo trang, tạo API."
+encoding: "UTF-8"
 agents: [backend-specialist, frontend-specialist, database-architect]
 related-skills: [plan, test, debug]
 ---
@@ -60,6 +61,9 @@ If any answer is unclear, ASK before proceeding.
 ## Quality Gate
 After completing, read `.kiro/skills/_scripts/checklist.md` for cross-cutting quality checks.
 
+## 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).
+
 ## Related Skills
 - `/plan` → read `.kiro/skills/plan/SKILL.md` — Plan before creating complex features
 - `/test` → read `.kiro/skills/test/SKILL.md` — Write tests for new code

package/skills/debug/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: debug
 description: "Root-cause analysis for bugs, failing commands, broken behavior, and error logs. Use when the user encounters errors, crashes, or unexpected behavior. Triggers: debug, fix, bug, error, crash, lỗi, sửa lỗi, hỏng, fail."
+encoding: "UTF-8"
 agents: [debugger, backend-specialist, frontend-specialist]
 related-skills: [test, enhance, status]
 ---
@@ -75,3 +76,6 @@ If any answer is missing, ASK before proceeding.
 - `/test` → read `.kiro/skills/test/SKILL.md` — Write tests to prevent regression
 - `/enhance` → read `.kiro/skills/enhance/SKILL.md` — Improve code quality after fixing
 - `/status` → read `.kiro/skills/status/SKILL.md` — Check project health after fix
+
+## 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).

package/skills/deploy/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: deploy
 description: "Deployment steps, release preparation, environment setup, CI/CD guidance, and production rollout. Use when the user wants to deploy, release, or set up infrastructure. Triggers: deploy, release, CI/CD, docker, production, triển khai, phát hành, đưa lên production."
+encoding: "UTF-8"
 agents: [devops-engineer, security-auditor]
 related-skills: [test, status, plan]
 ---
@@ -67,3 +68,6 @@ If any answer is unclear, ASK before proceeding.
 - `/test` → read `.kiro/skills/test/SKILL.md` — Run tests before deployment
 - `/status` → read `.kiro/skills/status/SKILL.md` — Check project readiness
 - `/plan` → read `.kiro/skills/plan/SKILL.md` — Plan complex deployment sequences
+
+## 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).

package/skills/enhance/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: enhance
 description: "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á."
+encoding: "UTF-8"
 agents: [performance-optimizer, security-auditor, frontend-specialist]
 related-skills: [debug, test, plan]
 ---
@@ -59,3 +60,6 @@ If any answer is unclear, ASK before proceeding.
 - `/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).

package/skills/explain/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: explain
 description: "Explain code, walk through logic, and help understand architecture or behavior. Use when the user asks what code does, how something works, or wants a walkthrough. Triggers: explain, what does this do, how does this work, giải thích, giải thích code, code này làm gì."
+encoding: "UTF-8"
 agents: [documentation-writer, backend-specialist, frontend-specialist]
 related-skills: [debug, enhance, status]
 ---
@@ -65,6 +66,7 @@ If any answer is unclear, ASK before proceeding.
 - If the code is unclear or has issues, mention them without derailing the explanation.
 - Avoid proposing wide changes mid-explanation; if improvement requires broader edits, ASK before switching to implementation.
 - Always read and update the memory file.
+ - Code encoding: All code snippets and files referenced or produced must be UTF-8 encoded. When providing example files, ensure they use UTF-8 and indicate `encoding: "UTF-8"` in front-matter where applicable.
 
 ## Related Skills
 - `/debug` → read `.kiro/skills/debug/SKILL.md` — If explanation reveals bugs

package/skills/instructions.md

@@ -1,5 +1,7 @@
 ## AI Agent Skills — System Bootstrap
 
+**Encoding rule**: All skill files, repository Markdown, and code must use UTF-8 encoding to avoid font and character issues. When producing or committing code examples, ensure files are saved as UTF-8 (no BOM) and include the front-matter field `encoding: "UTF-8"` in `SKILL.md` to document the requirement. Treat UTF-8 as the canonical encoding for the repo.
+
 This project uses an **AI Skills system** with 16 skills, 11 specialist agents, and a memory protocol.
 
 ### On EVERY request, follow this flow:

package/skills/integrate/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: integrate
 description: "Integrate provided sample code/snippets into the existing system with minimal changes and minimal risk. Use when the user gives a code mẫu and wants to merge it into current project. Triggers: integrate, merge snippet, gộp code mẫu, ghép code, áp code mẫu vào hệ thống."
+encoding: "UTF-8"
 agents: [backend-specialist, frontend-specialist, debugger]
 related-skills: [plan, test, debug, enhance]
 ---
@@ -51,3 +52,6 @@ Before editing, verify these inputs exist. If any is missing or ambiguous, ASK:
 - Verification performed (commands/tests)
 - Risks / follow-ups (if any)
 
+## 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).
+

package/skills/motion-ui/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: motion-ui
 description: "Advanced Motion UI (AMUI) — Create clean, modern UI with subtle Framer Motion micro-interactions, clear states (idle/loading/success/error), consistent styling via design tokens, and smooth animations. Use when the user wants motion-rich, polished UI with micro-interactions. Triggers: motion, animation, framer motion, micro-interaction, smooth ui, amui, chuyển động, hiệu ứng mượt."
+encoding: "UTF-8"
 agents: [frontend-specialist]
 related-skills: [create, ui-ux-pro-max, enhance]
 ---
@@ -362,6 +363,9 @@ After completing, read `.kiro/skills/_scripts/checklist.md` for cross-cutting qu
 - `/ui-ux-pro-max` → read `.kiro/skills/ui-ux-pro-max/SKILL.md` — Advanced UI/UX improvements
 - `/enhance` → read `.kiro/skills/enhance/SKILL.md` — Improve existing components with motion
 
+## 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).
+
 ## Example: AMUI Button Component
 
 ```tsx

package/skills/orchestrate/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: orchestrate
 description: "Coordinate multi-step plans across multiple roles, files, systems, or parallel workstreams. Use when the user has a complex request spanning multiple domains or needing decomposition. Triggers: orchestrate, coordinate, multi-step, full-stack, tổng hợp, làm nhiều bước."
+encoding: "UTF-8"
 agents: [orchestrator, project-planner]
 related-skills: [plan, create, deploy, test]
 ---
@@ -74,3 +75,6 @@ If any answer is unclear, ASK before proceeding.
 - `/create` → read `.kiro/skills/create/SKILL.md` — Execute creation tasks
 - `/deploy` → read `.kiro/skills/deploy/SKILL.md` — Deploy completed work
 - `/test` → read `.kiro/skills/test/SKILL.md` — Validate each workstream
+
+## 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).

package/skills/plan/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: plan
 description: "Create concrete implementation plans with milestones, task breakdowns, and estimates. Use when the user wants to plan, organize work, or create a roadmap. Triggers: plan, milestone, breakdown, roadmap, estimate, kế hoạch, lên kế hoạch, phân chia công việc."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [brainstorm, create, orchestrate]
 ---
@@ -70,3 +71,6 @@ After completing, read `.kiro/skills/_scripts/checklist.md` for cross-cutting qu
 - `/brainstorm` → read `.kiro/skills/brainstorm/SKILL.md` — Explore options before planning
 - `/create` → read `.kiro/skills/create/SKILL.md` — Execute planned tasks
 - `/orchestrate` → read `.kiro/skills/orchestrate/SKILL.md` — Coordinate complex plans across teams
+
+## 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).

package/skills/preview/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: preview
 description: "Preview expected output, UX flows, copy, interaction design, or generated content before implementing. Use when the user wants to see what something will look like. Triggers: preview, mockup, show me, xem trước, thử xem, mô phỏng."
+encoding: "UTF-8"
 agents: [frontend-specialist, documentation-writer]
 related-skills: [create, ui-ux-pro-max, plan]
 ---
@@ -56,3 +57,6 @@ After completing, read `.kiro/skills/_scripts/checklist.md` for cross-cutting qu
 - `/create` → read `.kiro/skills/create/SKILL.md` — Implement the previewed design
 - `/ui-ux-pro-max` → read `.kiro/skills/ui-ux-pro-max/SKILL.md` — Advanced UI/UX design
 - `/plan` → read `.kiro/skills/plan/SKILL.md` — Plan implementation of previewed feature
+
+## 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).

package/skills/status/SKILL.md

@@ -1,6 +1,7 @@
 ---
 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."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [plan, debug, deploy]
 ---
@@ -58,3 +59,6 @@ After completing, read `.kiro/skills/_scripts/verify-all.md` for full project ve
 - `/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
+
+## 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).

package/skills/test/SKILL.md

@@ -1,6 +1,7 @@
 ---
 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."
+encoding: "UTF-8"
 agents: [test-engineer, debugger]
 related-skills: [debug, create, enhance]
 ---
@@ -59,3 +60,6 @@ If any answer is unclear, ASK before proceeding.
 - `/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
+
+## 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).

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

@@ -1,6 +1,7 @@
 ---
 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."
+encoding: "UTF-8"
 agents: [frontend-specialist, performance-optimizer]
 related-skills: [create, preview, enhance]
 ---
@@ -66,3 +67,6 @@ If any answer is unclear, ASK before proceeding.
 - `/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
+
+## 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).