@anionzo/skill 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/CONTRIBUTING.md +302 -0
  2. package/LICENSE +21 -0
  3. package/README.md +209 -0
  4. package/adapters/README.md +13 -0
  5. package/adapters/claude-code/README.md +32 -0
  6. package/adapters/copilot/README.md +32 -0
  7. package/adapters/gemini/README.md +32 -0
  8. package/adapters/generic/README.md +32 -0
  9. package/adapters/opencode/README.md +32 -0
  10. package/docs/adapter-guide.md +62 -0
  11. package/docs/authoring-guide.md +69 -0
  12. package/docs/design-brief.md +97 -0
  13. package/docs/knowledge-spec.md +78 -0
  14. package/docs/research-notes.md +99 -0
  15. package/docs/skill-spec.md +107 -0
  16. package/i18n/CONTRIBUTING.vi.md +302 -0
  17. package/i18n/README.vi.md +209 -0
  18. package/i18n/adapter-guide.vi.md +62 -0
  19. package/i18n/authoring-guide.vi.md +69 -0
  20. package/i18n/design-brief.vi.md +97 -0
  21. package/i18n/knowledge-spec.vi.md +78 -0
  22. package/i18n/research-notes.vi.md +99 -0
  23. package/i18n/skill-spec.vi.md +107 -0
  24. package/knowledge/README.md +7 -0
  25. package/knowledge/global/debugging-patterns.md +20 -0
  26. package/knowledge/global/engineering-principles.md +23 -0
  27. package/knowledge/global/evidence-before-claims.md +20 -0
  28. package/knowledge/global/review-heuristics.md +23 -0
  29. package/knowledge/global/skill-triggering-rules.md +24 -0
  30. package/knowledge/project/README.md +10 -0
  31. package/knowledge/working/README.md +10 -0
  32. package/package.json +43 -0
  33. package/scripts/sync-platform-files +73 -0
  34. package/scripts/validate-skills +103 -0
  35. package/skills/brainstorming/SKILL.md +45 -0
  36. package/skills/brainstorming/examples.md +61 -0
  37. package/skills/brainstorming/meta.yaml +23 -0
  38. package/skills/brainstorming/references/output-template.md +26 -0
  39. package/skills/bug-triage/SKILL.md +47 -0
  40. package/skills/bug-triage/examples.md +68 -0
  41. package/skills/bug-triage/meta.yaml +25 -0
  42. package/skills/bug-triage/references/output-template.md +26 -0
  43. package/skills/code-review/SKILL.md +41 -0
  44. package/skills/code-review/examples.md +77 -0
  45. package/skills/code-review/meta.yaml +24 -0
  46. package/skills/code-review/references/checklist.md +34 -0
  47. package/skills/code-review/references/output-template.md +12 -0
  48. package/skills/docs-writer/SKILL.md +42 -0
  49. package/skills/docs-writer/examples.md +108 -0
  50. package/skills/docs-writer/meta.yaml +22 -0
  51. package/skills/docs-writer/references/output-template.md +17 -0
  52. package/skills/feature-delivery/SKILL.md +39 -0
  53. package/skills/feature-delivery/examples.md +83 -0
  54. package/skills/feature-delivery/meta.yaml +26 -0
  55. package/skills/feature-delivery/references/output-template.md +26 -0
  56. package/skills/planning/SKILL.md +61 -0
  57. package/skills/planning/examples.md +124 -0
  58. package/skills/planning/meta.yaml +29 -0
  59. package/skills/planning/references/output-template.md +37 -0
  60. package/skills/refactor-safe/SKILL.md +53 -0
  61. package/skills/refactor-safe/examples.md +96 -0
  62. package/skills/refactor-safe/meta.yaml +28 -0
  63. package/skills/refactor-safe/references/output-template.md +37 -0
  64. package/skills/repo-onboarding/SKILL.md +52 -0
  65. package/skills/repo-onboarding/examples.md +115 -0
  66. package/skills/repo-onboarding/meta.yaml +23 -0
  67. package/skills/repo-onboarding/references/output-template.md +24 -0
  68. package/skills/using-skills/SKILL.md +108 -0
  69. package/skills/using-skills/examples.md +79 -0
  70. package/skills/using-skills/meta.yaml +29 -0
  71. package/skills/using-skills/references/output-template.md +14 -0
  72. package/skills/verification-before-completion/SKILL.md +46 -0
  73. package/skills/verification-before-completion/examples.md +83 -0
  74. package/skills/verification-before-completion/meta.yaml +26 -0
  75. package/skills/verification-before-completion/references/checklist.md +7 -0
  76. package/skills/verification-before-completion/references/output-template.md +16 -0
  77. package/templates/SKILL.md +29 -0
  78. package/templates/examples.md +13 -0
  79. package/templates/meta.yaml +14 -0
  80. package/templates/output-template.md +11 -0
@@ -0,0 +1,83 @@
1
+ # Examples
2
+
3
+ ## Example 1
4
+
5
+ User request:
6
+
7
+ ```text
8
+ If the tests pass, commit it.
9
+ ```
10
+
11
+ Expected result:
12
+
13
+ - run the relevant tests first
14
+ - report whether the claim is verified
15
+ - only then move to the next step
16
+
17
+ ### Completed output — Example 1
18
+
19
+ ```
20
+ Claim being checked: All relevant tests pass after the recent changes.
21
+
22
+ Evidence run: npm test (full suite, 847 tests)
23
+
24
+ Result:
25
+ Test Suites: 42 passed, 42 total
26
+ Tests: 847 passed, 847 total
27
+ Time: 23.4s
28
+
29
+ Final status: verified
30
+
31
+ Remaining uncertainty: None — full test suite passed. No skipped or pending tests.
32
+
33
+ Next step: safe to commit. Hand off to code-review if a review is warranted.
34
+ ```
35
+
36
+ ### Completed output — Example 2
37
+
38
+ ```
39
+ Claim being checked: The original bug (users logged out randomly) is fixed.
40
+
41
+ Evidence run:
42
+ 1. Restored SESSION_TTL to 3600 in production config and redeployed
43
+ 2. Created 5 test sessions and monitored for 30 minutes — all remained active
44
+ 3. Ran auth integration tests: 12/12 passing (previously 2 were failing with timeout)
45
+
46
+ Result:
47
+ Session stability: 5/5 sessions remained active for 30+ minutes
48
+ Auth tests: 12/12 passing (was 10/12 before fix)
49
+ Error logs: No session-related errors in the last 30 minutes
50
+
51
+ Final status: verified
52
+
53
+ Remaining uncertainty: Long-running sessions (>24h) were not tested. The SESSION_TTL of 3600 means sessions should last 1 hour — if users report issues beyond that, the TTL value itself may need review.
54
+
55
+ Next step: safe to close the bug ticket. Consider adding a session-duration regression test.
56
+ ```
57
+
58
+ ## Example 3 — Sample completed output
59
+
60
+ User request:
61
+
62
+ ```text
63
+ If the tests pass, commit it.
64
+ ```
65
+
66
+ ### Completed output
67
+
68
+ ```
69
+ Claim being checked: All relevant tests pass after the recent changes.
70
+
71
+ Evidence run: npm test (full suite, 847 tests)
72
+
73
+ Result:
74
+ Test Suites: 42 passed, 42 total
75
+ Tests: 847 passed, 847 total
76
+ Time: 23.4s
77
+
78
+ Final status: verified
79
+
80
+ Remaining uncertainty: None — full test suite passed. No skipped or pending tests.
81
+
82
+ Next step: safe to commit. Hand off to code-review if a review is warranted.
83
+ ```
@@ -0,0 +1,26 @@
1
+ name: verification-before-completion
2
+ version: 0.1.0
3
+ category: verification
4
+ summary: Require fresh evidence before claiming work is done, fixed, passing, or ready.
5
+ summary_vi: Yêu cầu bằng chứng mới trước khi tuyên bố công việc đã xong, đã sửa, đã pass, hoặc sẵn sàng.
6
+ triggers:
7
+ - before saying a fix works
8
+ - before marking work complete
9
+ - before commit, PR, or handoff
10
+ inputs:
11
+ - work completed so far
12
+ - relevant verification commands or checks
13
+ outputs:
14
+ - verified claim
15
+ - blocked verification note
16
+ - remaining uncertainty
17
+ constraints:
18
+ - no success claims without fresh evidence
19
+ - if verification is blocked, say so plainly
20
+ related_skills:
21
+ - using-skills
22
+ - feature-delivery
23
+ - bug-triage
24
+ - refactor-safe
25
+ - planning
26
+ - code-review
@@ -0,0 +1,7 @@
1
+ ## Verification Checklist
2
+
3
+ 1. What exact claim is being made?
4
+ 2. What command or check proves it?
5
+ 3. Was that check run fresh?
6
+ 4. What was the actual result?
7
+ 5. Is the claim verified, failed, or blocked?
@@ -0,0 +1,16 @@
1
+ # Verification Output Template
2
+
3
+ ```
4
+ Claim being checked: <state the exact claim>
5
+
6
+ Evidence run: <commands or checks executed>
7
+
8
+ Result:
9
+ <output or metrics>
10
+
11
+ Final status: verified | unverified | partially verified
12
+
13
+ Remaining uncertainty: <what could not be confirmed>
14
+
15
+ Next step: <action or handoff>
16
+ ```
@@ -0,0 +1,29 @@
1
+ # Skill Name
2
+
3
+ ## Purpose
4
+
5
+ State the job this skill performs.
6
+
7
+ ## When To Use
8
+
9
+ - Trigger 1
10
+ - Trigger 2
11
+
12
+ ## Workflow
13
+
14
+ 1. First step
15
+ 2. Second step
16
+ 3. Verification or handoff step
17
+
18
+ ## Output Format
19
+
20
+ - Main sections the response or result should contain
21
+
22
+ ## Red Flags
23
+
24
+ - Common mistake 1
25
+ - Common mistake 2
26
+
27
+ ## Done Criteria
28
+
29
+ State what it means for this skill to be complete.
@@ -0,0 +1,13 @@
1
+ # Examples
2
+
3
+ ## Example 1
4
+
5
+ User request:
6
+
7
+ ```text
8
+ Describe a realistic request here.
9
+ ```
10
+
11
+ Expected result:
12
+
13
+ - Describe the expected routing, behavior, or output
@@ -0,0 +1,14 @@
1
+ name: skill-name
2
+ version: 0.1.0
3
+ category: category
4
+ summary: One sentence describing the skill and its value.
5
+ triggers:
6
+ - trigger phrase
7
+ inputs:
8
+ - input type
9
+ outputs:
10
+ - output type
11
+ constraints:
12
+ - important constraint
13
+ related_skills:
14
+ - another-skill
@@ -0,0 +1,11 @@
1
+ ## Context
2
+
3
+ - Relevant context item
4
+
5
+ ## Result
6
+
7
+ - Main output item
8
+
9
+ ## Follow-Up
10
+
11
+ - Remaining question or next step