@anionzo/skill 1.4.0 → 1.7.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 (57) hide show
  1. package/CONTRIBUTING.md +2 -1
  2. package/README.md +82 -24
  3. package/docs/design-brief.md +17 -13
  4. package/docs/knowledge-spec.md +1 -0
  5. package/i18n/CONTRIBUTING.vi.md +2 -1
  6. package/i18n/README.vi.md +82 -24
  7. package/i18n/design-brief.vi.md +17 -13
  8. package/i18n/knowledge-spec.vi.md +1 -0
  9. package/knowledge/global/skill-triggering-rules.md +3 -2
  10. package/package.json +1 -1
  11. package/scripts/install-opencode-skills +197 -35
  12. package/skills/brainstorming/SKILL.md +176 -13
  13. package/skills/brainstorming/meta.yaml +18 -10
  14. package/skills/code-review/SKILL.md +214 -19
  15. package/skills/code-review/meta.yaml +21 -9
  16. package/skills/commit/SKILL.md +187 -0
  17. package/skills/commit/examples.md +62 -0
  18. package/skills/commit/meta.yaml +29 -0
  19. package/skills/commit/references/output-template.md +14 -0
  20. package/skills/debug/SKILL.md +252 -0
  21. package/skills/debug/examples.md +83 -0
  22. package/skills/debug/meta.yaml +39 -0
  23. package/skills/debug/references/output-template.md +16 -0
  24. package/skills/docs-writer/SKILL.md +85 -10
  25. package/skills/docs-writer/meta.yaml +18 -13
  26. package/skills/extract/SKILL.md +201 -0
  27. package/skills/extract/examples.md +47 -0
  28. package/skills/extract/meta.yaml +33 -0
  29. package/skills/extract/references/output-template.md +24 -0
  30. package/skills/feature-delivery/SKILL.md +12 -5
  31. package/skills/feature-delivery/meta.yaml +6 -1
  32. package/skills/planning/SKILL.md +146 -17
  33. package/skills/planning/meta.yaml +19 -7
  34. package/skills/refactor-safe/SKILL.md +10 -7
  35. package/skills/research/SKILL.md +130 -0
  36. package/skills/research/examples.md +79 -0
  37. package/skills/research/meta.yaml +31 -0
  38. package/skills/research/references/output-template.md +23 -0
  39. package/skills/test-driven-development/SKILL.md +194 -0
  40. package/skills/test-driven-development/examples.md +77 -0
  41. package/skills/test-driven-development/meta.yaml +31 -0
  42. package/skills/test-driven-development/references/.gitkeep +0 -0
  43. package/skills/test-driven-development/references/output-template.md +31 -0
  44. package/skills/using-skills/SKILL.md +33 -17
  45. package/skills/using-skills/examples.md +20 -5
  46. package/skills/using-skills/meta.yaml +7 -4
  47. package/skills/verification-before-completion/SKILL.md +127 -13
  48. package/skills/verification-before-completion/meta.yaml +23 -14
  49. package/templates/SKILL.md +8 -1
  50. package/skills/bug-triage/SKILL.md +0 -47
  51. package/skills/bug-triage/examples.md +0 -68
  52. package/skills/bug-triage/meta.yaml +0 -25
  53. package/skills/bug-triage/references/output-template.md +0 -26
  54. package/skills/repo-onboarding/SKILL.md +0 -52
  55. package/skills/repo-onboarding/examples.md +0 -115
  56. package/skills/repo-onboarding/meta.yaml +0 -23
  57. package/skills/repo-onboarding/references/output-template.md +0 -24
@@ -1,115 +0,0 @@
1
- # Examples
2
-
3
- ## Example 1
4
-
5
- User request:
6
-
7
- ```text
8
- Can you explain how this service is structured before we add a queue worker?
9
- ```
10
-
11
- Expected result:
12
-
13
- - read top-level docs first
14
- - inspect runtime entrypoints and worker-related modules
15
- - summarize current architecture and likely integration points
16
-
17
- ### Completed output — Example 1
18
-
19
- ```
20
- Project purpose: Order processing microservice — receives orders via REST API, persists to PostgreSQL, publishes events to RabbitMQ.
21
-
22
- Architecture summary: Express.js app using a layered structure (routes → controllers → services → repositories). Bull is already listed in package.json but no active queue consumer exists.
23
-
24
- Major components:
25
- - src/routes/ — REST endpoint definitions
26
- - src/controllers/ — request handling and validation
27
- - src/services/ — business logic (OrderService, PaymentService)
28
- - src/repositories/ — Knex-based database access
29
- - src/events/ — RabbitMQ publisher (no consumer yet)
30
-
31
- Important commands:
32
- - npm run dev — start with hot reload
33
- - npm test — jest unit + integration tests
34
- - npm run migrate — run Knex migrations
35
-
36
- Notable conventions:
37
- - All services are instantiated via a simple DI container in src/container.ts
38
- - Tests use a shared test database seeded per suite
39
-
40
- Open questions:
41
- - Is Bull the intended queue driver, or should the new worker use the existing RabbitMQ publisher?
42
- - Are there any existing retry/dead-letter conventions?
43
-
44
- Recommended next reads: src/events/publisher.ts, src/container.ts, config/queue.ts (if present)
45
- ```
46
-
47
- ### Completed output — Example 2
48
-
49
- ```
50
- Project purpose: Internal dashboard for managing feature flags and A/B test configurations.
51
-
52
- First things to read:
53
- 1. README.md — setup instructions and architecture overview (up to date, last edited 2 weeks ago)
54
- 2. package.json scripts — `npm run dev`, `npm test`, `npm run build`, `npm run seed`
55
- 3. src/config/ — environment variable definitions and feature flag schema
56
- 4. prisma/schema.prisma — data model (3 main tables: Flag, Variant, Assignment)
57
-
58
- Important commands:
59
- - npm run dev — Next.js dev server on port 3000
60
- - npm test — Vitest test suite (47 tests, all passing)
61
- - npm run seed — seed local database with sample flags
62
- - npx prisma studio — open database GUI
63
-
64
- Directory overview:
65
- - src/app/ — Next.js App Router pages and layouts
66
- - src/lib/ — shared utilities (flag evaluation engine, auth helpers)
67
- - src/components/ — React UI components
68
- - prisma/ — database schema and migrations
69
- - e2e/ — Playwright end-to-end tests
70
-
71
- Notable conventions:
72
- - Server components by default; client components marked with "use client"
73
- - Flag evaluation happens server-side via src/lib/evaluate.ts
74
- - Auth is handled via NextAuth with GitHub OAuth only
75
-
76
- Recommended next step: Run `npm run dev && npm run seed` to get a local instance with sample data, then explore the flag management UI at /flags.
77
- ```
78
-
79
- ## Example 3 — Sample completed output
80
-
81
- User request:
82
-
83
- ```text
84
- Can you explain how this service is structured before we add a queue worker?
85
- ```
86
-
87
- ### Completed output
88
-
89
- ```
90
- Project purpose: Order processing microservice — receives orders via REST API, persists to PostgreSQL, publishes events to RabbitMQ.
91
-
92
- Architecture summary: Express.js app using a layered structure (routes → controllers → services → repositories). Bull is already listed in package.json but no active queue consumer exists.
93
-
94
- Major components:
95
- - src/routes/ — REST endpoint definitions
96
- - src/controllers/ — request handling and validation
97
- - src/services/ — business logic (OrderService, PaymentService)
98
- - src/repositories/ — Knex-based database access
99
- - src/events/ — RabbitMQ publisher (no consumer yet)
100
-
101
- Important commands:
102
- - npm run dev — start with hot reload
103
- - npm test — jest unit + integration tests
104
- - npm run migrate — run Knex migrations
105
-
106
- Notable conventions:
107
- - All services are instantiated via a simple DI container in src/container.ts
108
- - Tests use a shared test database seeded per suite
109
-
110
- Open questions:
111
- - Is Bull the intended queue driver, or should the new worker use the existing RabbitMQ publisher?
112
- - Are there any existing retry/dead-letter conventions?
113
-
114
- Recommended next reads: src/events/publisher.ts, src/container.ts, config/queue.ts (if present)
115
- ```
@@ -1,23 +0,0 @@
1
- name: repo-onboarding
2
- version: 0.1.0
3
- category: discovery
4
- summary: Build a practical map of an unfamiliar repository before making claims or edits.
5
- summary_vi: Xây dựng bản đồ thực tế của repo lạ trước khi đưa ra nhận định hoặc sửa code.
6
- triggers:
7
- - explain this repo
8
- - onboard into a codebase
9
- - understand architecture before changing code
10
- inputs:
11
- - repository files
12
- - README and operating docs when present
13
- outputs:
14
- - architecture summary
15
- - important commands
16
- - open questions and next reads
17
- constraints:
18
- - prefer source-grounded observations
19
- - do not infer architecture from names alone
20
- related_skills:
21
- - using-skills
22
- - planning
23
- - docs-writer
@@ -1,24 +0,0 @@
1
- ## Project Purpose
2
-
3
- - What the project is for
4
-
5
- ## Architecture Summary
6
-
7
- - Runtime or framework:
8
- - Major subsystems:
9
- - External integrations:
10
-
11
- ## Important Commands
12
-
13
- - install:
14
- - test:
15
- - build:
16
- - run:
17
-
18
- ## Open Questions
19
-
20
- - Unknowns that still need deeper inspection
21
-
22
- ## Recommended Next Reads
23
-
24
- - Files or directories to inspect next