@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.
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +209 -0
- package/adapters/README.md +13 -0
- package/adapters/claude-code/README.md +32 -0
- package/adapters/copilot/README.md +32 -0
- package/adapters/gemini/README.md +32 -0
- package/adapters/generic/README.md +32 -0
- package/adapters/opencode/README.md +32 -0
- package/docs/adapter-guide.md +62 -0
- package/docs/authoring-guide.md +69 -0
- package/docs/design-brief.md +97 -0
- package/docs/knowledge-spec.md +78 -0
- package/docs/research-notes.md +99 -0
- package/docs/skill-spec.md +107 -0
- package/i18n/CONTRIBUTING.vi.md +302 -0
- package/i18n/README.vi.md +209 -0
- package/i18n/adapter-guide.vi.md +62 -0
- package/i18n/authoring-guide.vi.md +69 -0
- package/i18n/design-brief.vi.md +97 -0
- package/i18n/knowledge-spec.vi.md +78 -0
- package/i18n/research-notes.vi.md +99 -0
- package/i18n/skill-spec.vi.md +107 -0
- package/knowledge/README.md +7 -0
- package/knowledge/global/debugging-patterns.md +20 -0
- package/knowledge/global/engineering-principles.md +23 -0
- package/knowledge/global/evidence-before-claims.md +20 -0
- package/knowledge/global/review-heuristics.md +23 -0
- package/knowledge/global/skill-triggering-rules.md +24 -0
- package/knowledge/project/README.md +10 -0
- package/knowledge/working/README.md +10 -0
- package/package.json +43 -0
- package/scripts/sync-platform-files +73 -0
- package/scripts/validate-skills +103 -0
- package/skills/brainstorming/SKILL.md +45 -0
- package/skills/brainstorming/examples.md +61 -0
- package/skills/brainstorming/meta.yaml +23 -0
- package/skills/brainstorming/references/output-template.md +26 -0
- package/skills/bug-triage/SKILL.md +47 -0
- package/skills/bug-triage/examples.md +68 -0
- package/skills/bug-triage/meta.yaml +25 -0
- package/skills/bug-triage/references/output-template.md +26 -0
- package/skills/code-review/SKILL.md +41 -0
- package/skills/code-review/examples.md +77 -0
- package/skills/code-review/meta.yaml +24 -0
- package/skills/code-review/references/checklist.md +34 -0
- package/skills/code-review/references/output-template.md +12 -0
- package/skills/docs-writer/SKILL.md +42 -0
- package/skills/docs-writer/examples.md +108 -0
- package/skills/docs-writer/meta.yaml +22 -0
- package/skills/docs-writer/references/output-template.md +17 -0
- package/skills/feature-delivery/SKILL.md +39 -0
- package/skills/feature-delivery/examples.md +83 -0
- package/skills/feature-delivery/meta.yaml +26 -0
- package/skills/feature-delivery/references/output-template.md +26 -0
- package/skills/planning/SKILL.md +61 -0
- package/skills/planning/examples.md +124 -0
- package/skills/planning/meta.yaml +29 -0
- package/skills/planning/references/output-template.md +37 -0
- package/skills/refactor-safe/SKILL.md +53 -0
- package/skills/refactor-safe/examples.md +96 -0
- package/skills/refactor-safe/meta.yaml +28 -0
- package/skills/refactor-safe/references/output-template.md +37 -0
- package/skills/repo-onboarding/SKILL.md +52 -0
- package/skills/repo-onboarding/examples.md +115 -0
- package/skills/repo-onboarding/meta.yaml +23 -0
- package/skills/repo-onboarding/references/output-template.md +24 -0
- package/skills/using-skills/SKILL.md +108 -0
- package/skills/using-skills/examples.md +79 -0
- package/skills/using-skills/meta.yaml +29 -0
- package/skills/using-skills/references/output-template.md +14 -0
- package/skills/verification-before-completion/SKILL.md +46 -0
- package/skills/verification-before-completion/examples.md +83 -0
- package/skills/verification-before-completion/meta.yaml +26 -0
- package/skills/verification-before-completion/references/checklist.md +7 -0
- package/skills/verification-before-completion/references/output-template.md +16 -0
- package/templates/SKILL.md +29 -0
- package/templates/examples.md +13 -0
- package/templates/meta.yaml +14 -0
- 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,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,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
|