@anionzo/skill 1.6.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 (34) hide show
  1. package/README.md +65 -19
  2. package/docs/design-brief.md +3 -5
  3. package/docs/knowledge-spec.md +1 -0
  4. package/i18n/README.vi.md +65 -19
  5. package/i18n/design-brief.vi.md +3 -5
  6. package/i18n/knowledge-spec.vi.md +1 -0
  7. package/knowledge/global/skill-triggering-rules.md +1 -1
  8. package/package.json +1 -1
  9. package/scripts/install-opencode-skills +197 -35
  10. package/skills/brainstorming/SKILL.md +3 -3
  11. package/skills/brainstorming/meta.yaml +0 -1
  12. package/skills/commit/meta.yaml +0 -1
  13. package/skills/debug/meta.yaml +1 -0
  14. package/skills/docs-writer/meta.yaml +2 -1
  15. package/skills/extract/SKILL.md +48 -8
  16. package/skills/extract/meta.yaml +12 -6
  17. package/skills/feature-delivery/SKILL.md +3 -1
  18. package/skills/feature-delivery/meta.yaml +2 -2
  19. package/skills/planning/SKILL.md +19 -1
  20. package/skills/planning/meta.yaml +8 -5
  21. package/skills/research/SKILL.md +33 -3
  22. package/skills/research/meta.yaml +9 -5
  23. package/skills/using-skills/SKILL.md +4 -6
  24. package/skills/using-skills/examples.md +17 -2
  25. package/skills/using-skills/meta.yaml +1 -3
  26. package/skills/verification-before-completion/meta.yaml +0 -1
  27. package/skills/go-pipeline/SKILL.md +0 -156
  28. package/skills/go-pipeline/examples.md +0 -56
  29. package/skills/go-pipeline/meta.yaml +0 -27
  30. package/skills/go-pipeline/references/output-template.md +0 -17
  31. package/skills/repo-onboarding/SKILL.md +0 -56
  32. package/skills/repo-onboarding/examples.md +0 -115
  33. package/skills/repo-onboarding/meta.yaml +0 -25
  34. package/skills/repo-onboarding/references/output-template.md +0 -24
@@ -1,56 +0,0 @@
1
- # Examples
2
-
3
- ## Example 1
4
-
5
- User request:
6
-
7
- ```text
8
- The user-notifications spec is approved. Just build it all.
9
- ```
10
-
11
- Expected result:
12
-
13
- - validate the spec
14
- - generate tasks from requirements
15
- - plan and implement each task
16
- - verify all ACs
17
- - present commit for approval
18
-
19
- Sample completed output:
20
-
21
- ```
22
- Goal/Result: Pipeline complete — 4 tasks implemented, all ACs verified.
23
-
24
- Key Details:
25
- Spec: user-notifications (approved)
26
-
27
- Tasks completed: 4/4
28
- 1. Add notification model and database migration — DONE
29
- 2. Implement notification service with email + in-app delivery — DONE
30
- 3. Add user notification preferences API — DONE
31
- 4. Wire notification triggers into existing user events — DONE
32
-
33
- Tasks blocked: 0
34
-
35
- AC Coverage: 5/5 (100%)
36
- - AC-1: Notifications created on user events — VERIFIED
37
- - AC-2: Email delivery via SendGrid — VERIFIED
38
- - AC-3: In-app notifications visible in UI — VERIFIED
39
- - AC-4: User preferences respected — VERIFIED
40
- - AC-5: Delivery failures logged — VERIFIED
41
-
42
- Build: PASS
43
- Tests: 58/58 PASS (12 new)
44
- Lint: PASS
45
-
46
- Commit proposal:
47
- feat(notifications): implement user notification system
48
-
49
- - Add notification model with email + in-app channels
50
- - Implement notification service with delivery tracking
51
- - Add user preferences API for per-channel control
52
- - Wire notifications into user registration and order events
53
- - All 5 acceptance criteria verified
54
-
55
- Proceed? (yes / no / edit)
56
- ```
@@ -1,27 +0,0 @@
1
- name: go-pipeline
2
- version: 0.1.0
3
- category: workflow
4
- summary: Execute a full spec-to-commit pipeline in one continuous run with minimal review gates.
5
- summary_vi: "Th\u1EF1c thi to\xE0n b\u1ED9 pipeline t\u1EEB spec \u0111\u1EBFn commit trong m\u1ED9t l\u01B0\u1EE3t li\xEAn t\u1EE5c v\u1EDBi \xEDt gate review."
6
- triggers:
7
- - go mode
8
- - run all
9
- - execute everything
10
- - just build it
11
- inputs:
12
- - approved spec document
13
- outputs:
14
- - implemented tasks
15
- - verification results
16
- - conventional commit
17
- constraints:
18
- - spec must be approved before starting
19
- - commit requires user approval
20
- - checkpoint on context budget
21
- related_skills:
22
- - using-skills
23
- - brainstorming
24
- - planning
25
- - feature-delivery
26
- - verification-before-completion
27
- - commit
@@ -1,17 +0,0 @@
1
- ## Goal/Result
2
-
3
- - Pipeline status:
4
-
5
- ## Key Details
6
-
7
- - Spec:
8
- - Tasks created:
9
- - Tasks completed:
10
- - Tasks blocked:
11
- - AC coverage:
12
- - Build/test status:
13
- - Commit proposal:
14
-
15
- ## Next Action
16
-
17
- -
@@ -1,56 +0,0 @@
1
- # Repo Onboarding
2
-
3
- ## Purpose
4
-
5
- Understand a repository quickly enough to act safely and explain what matters.
6
-
7
- ## When To Use
8
-
9
- Load this skill when:
10
-
11
- - entering a repo for the first time
12
- - a task depends on understanding architecture or conventions
13
- - the user asks what the project does or how it is organized
14
-
15
- ## Workflow
16
-
17
- 1. Read the top-level operating docs first, especially `AGENTS.md` and `README.md` when present.
18
- 2. Inspect the most informative source files next:
19
- - package manifests or build files
20
- - app entrypoints and framework bootstraps
21
- - core config files
22
- - representative tests
23
- 3. Identify:
24
- - project purpose
25
- - major components
26
- - runtime model and key integrations
27
- - important development or verification commands
28
- 4. Call out what is verified from source versus what is still uncertain.
29
- 5. Recommend the next files or directories to inspect for the user's likely goal.
30
-
31
- ## Output Format
32
-
33
- Present results using the Shared Output Contract:
34
-
35
- 1. **Goal/Result** — the repo understood and key findings
36
- 2. **Key Details:**
37
- - project purpose
38
- - architecture summary
39
- - major components and responsibilities
40
- - important commands or workflows
41
- - notable conventions or constraints
42
- - open questions
43
- 3. **Next Action** — `planning` (to plan a change), `research` (to go deeper on a topic), or `docs-writer` (to update documentation)
44
-
45
- ## Red Flags
46
-
47
- - skipping repo docs and jumping straight into random source files
48
- - summarizing architecture from folder names alone
49
- - claiming a behavior without checking source or config
50
- - reading many low-value files while missing the actual entrypoints
51
-
52
- ## Done Criteria
53
-
54
- This skill is complete when another engineer could start productive work from the summary without redoing the same orientation pass. Both the "Important Commands" and "Open Questions" fields must be populated.
55
-
56
- After this skill, the natural next step is `planning` (to plan a change) or `docs-writer` (if the goal is to update documentation).
@@ -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,25 +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
- - research
24
- - feature-delivery
25
- - 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