Skip to content

Commit 9243e8d

Browse files
committed
feat(skills): ship default end-user skill pack (bundled v5)
Install the model-invoked workflow catalog on fresh install and upgrade: debug/test/review/plan/implement and related end-user skills, power explicit-only batch/dependency-update/release, and docx/pptx/xlsx with documents/presentations/spreadsheets compatibility aliases. Non-destructive upgrade rules: never overwrite a skill body that no longer matches the shipped asset; safely retire unchanged v4-best-practices via exact body match; keep Feishu optional rather than universal. Closes #4691 Signed-off-by: Hunter B <hmbown@gmail.com>
1 parent 7ff195c commit 9243e8d

24 files changed

Lines changed: 741 additions & 117 deletions

File tree

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
name: batch
3+
description: Break a large, parallelizable goal into bounded work units, coordinate existing agent/worktree machinery, integrate, and verify. Explicit-only.
4+
invocation: explicit-only
5+
---
6+
7+
# Batch
8+
9+
## Invocation
10+
Explicit-only. Do not start from ambient wording alone.
11+
12+
## When to use
13+
Use for large parallelizable goals that need coordinated sub-work.
14+
15+
## Non-goals
16+
- Do not invent a second orchestration engine; reuse delegate/fleet.
17+
- Do not publish or deploy as part of batching.
18+
19+
## Workflow
20+
1. Partition into bounded units.
21+
2. Run units with existing agent/worktree tools.
22+
3. Integrate results and verify.
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
name: dataviz
3+
description: Choose and produce an appropriate chart/dashboard/visual explanation from data, with legible encodings and source/assumption notes.
4+
invocation: model+user
5+
---
6+
7+
# Dataviz
8+
9+
## When to use
10+
Use when the user needs a chart, dashboard, or visual explanation of data.
11+
12+
## Non-goals
13+
- Do not choose chart types that hide uncertainty.
14+
- Do not invent data.
15+
16+
## Workflow
17+
1. Inspect the data and questions.
18+
2. Choose encodings for the comparison at hand.
19+
3. Produce the visual with source/assumption notes.
20+
4. Sanity-check axes, units, and missing values.
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
name: debug
3+
description: Reproduce, minimize, localize, identify root cause, and distinguish diagnosis from an authorized fix. Prefer root-cause over symptom patches.
4+
invocation: model+user
5+
---
6+
7+
# Debug
8+
9+
## When to use
10+
Use for failures, flakes, wrong outputs, crashes, and regressions.
11+
12+
## Non-goals
13+
- Do not jump to a fix before reproduction/localization when the bug is unclear.
14+
- Do not treat “run all tests” as debugging by default.
15+
16+
## Workflow
17+
1. Reproduce or gather the strongest available failure signal.
18+
2. Minimize the case.
19+
3. Localize to component/file/line.
20+
4. State root cause vs symptoms.
21+
5. Fix only when authorized; otherwise hand back a diagnosis with evidence.
22+
23+
## Output shape
24+
- Symptom
25+
- Reproduction
26+
- Localization
27+
- Root cause
28+
- Fix status / next step
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
name: dependency-update
3+
description: Read release notes/changelogs, update a defined dependency scope, handle breaking changes, and verify. Explicit-only; no broad update-everything by inference.
4+
invocation: explicit-only
5+
---
6+
7+
# Dependency Update
8+
9+
## Invocation
10+
Explicit-only with a defined dependency scope.
11+
12+
## Non-goals
13+
- No inferred “update everything”.
14+
- No publish/release.
15+
16+
## Workflow
17+
1. Identify the dependency set and current versions.
18+
2. Read release notes/changelogs.
19+
3. Apply updates and fix breakages.
20+
4. Verify with the project’s test/build gates.
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
name: document
3+
description: Write or update repository/product documentation: README, user guides, API docs, architecture, migration notes, and changelog material. This is not the Word-document artifact skill.
4+
invocation: model+user
5+
---
6+
7+
# Document
8+
9+
## When to use
10+
Use for repo/product docs: README, guides, API docs, architecture, migrations, changelog notes.
11+
12+
## Non-goals
13+
- Not Word/DOCX authoring (use docx).
14+
- Not release publication (use release only when explicit).
15+
16+
## Workflow
17+
1. Identify the doc audience and location.
18+
2. Prefer updating existing docs over creating duplicates.
19+
3. Keep commands and paths verified.
20+
4. Call out unknowns instead of inventing them.
Lines changed: 5 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,11 @@
11
---
22
name: documents
3-
description: Create, edit, inspect, or convert Word documents and DOCX deliverables such as memos, reports, letters, templates, and forms.
3+
description: Compatibility alias for the docx skill. Prefer loading docx.
4+
aliases-for: docx
45
---
56

6-
# Documents
7+
# documents (alias)
78

8-
Use this skill when the user wants a `.docx` or Word-style document, or when an
9-
existing document needs edits, comments, extraction, or conversion.
9+
This skill is a compatibility alias for **docx**.
1010

11-
## Workflow
12-
13-
1. Clarify the output path if needed. Prefer a `.docx` file in the workspace.
14-
2. Preserve existing documents. Write edited copies instead of overwriting
15-
originals unless the user asked for an in-place edit.
16-
3. Use the best available local tool:
17-
- `python-docx` for creation and structured edits
18-
- `pandoc` for Markdown/HTML to DOCX conversion
19-
- OOXML inspection with `unzip` only for targeted low-level fixes
20-
4. For new documents, choose a simple professional structure: title, metadata
21-
when useful, clear headings, readable body text, and tables only for real
22-
row/column data.
23-
5. For edits, make the smallest change that satisfies the request and keep the
24-
original formatting where practical.
25-
6. Verify by reopening the file with a parser such as `python-docx`, checking
26-
paragraph/table counts, and extracting representative text. If LibreOffice
27-
or another renderer is available, render or export a quick visual check.
28-
29-
If required dependencies are missing, ask before installing packages. If the
30-
user only needs content and a DOCX cannot be produced in the environment, offer
31-
Markdown or HTML as a fallback and clearly state the limitation.
11+
Load and follow the `docx` skill body for the actual workflow.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
name: docx
3+
description: Create/edit/inspect Word documents using available managed or host capabilities.
4+
invocation: model+user
5+
---
6+
7+
# Docx
8+
9+
## When to use
10+
Use for `.docx` / Word-style documents (memos, reports, letters, templates).
11+
12+
## Compatibility
13+
`documents` is a compatibility alias for this skill.
14+
15+
## Workflow
16+
1. Prefer `.docx` in the workspace.
17+
2. Preserve originals unless in-place edit is requested.
18+
3. Use python-docx/pandoc when available.
19+
4. Verify by reopening and extracting representative text.
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
name: frontend-design
3+
description: Produce intentional, responsive, accessible UI work and perform visual QA instead of generic component assembly.
4+
invocation: model+user
5+
---
6+
7+
# Frontend Design
8+
9+
## When to use
10+
Use for UI that must feel intentional, responsive, and accessible.
11+
12+
## Non-goals
13+
- Do not ship generic placeholder layouts as finished design.
14+
- Do not ignore accessibility.
15+
16+
## Workflow
17+
1. Clarify audience and constraints.
18+
2. Design hierarchy, spacing, and states.
19+
3. Implement with responsive/accessible patterns.
20+
4. Visual QA against the acceptance criteria.
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
name: implement
3+
description: Carry an authorized, defined request or approved plan through scoped edits and proportionate verification. Skill loading is not write authorization by itself.
4+
invocation: model+user
5+
---
6+
7+
# Implement
8+
9+
## When to use
10+
Use for scoped implementation of a clear request or approved plan.
11+
12+
## Non-goals
13+
- Loading this skill is not write authorization by itself.
14+
- Do not expand scope without saying so.
15+
- Do not skip verification after risky edits.
16+
17+
## Workflow
18+
1. Confirm scope and acceptance criteria.
19+
2. Make the smallest coherent change set.
20+
3. Run the narrowest useful verification.
21+
4. Report what changed and what remains.
22+
23+
## Failure mode
24+
If blocked by missing permissions or failing verification, stop and report evidence.
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
name: interview
3+
description: Ask one useful structured question at a time only when material product/implementation choices are genuinely missing; remember answers and produce a brief/spec. Discoverable facts should be investigated instead of asked.
4+
invocation: model+user
5+
---
6+
7+
# Interview
8+
9+
## When to use
10+
Use when the request lacks a material product or implementation choice that cannot be discovered from the workspace or tools.
11+
12+
## Non-goals
13+
- Do not interview for facts you can read, search, or measure.
14+
- Do not ask multi-question dumps. One focused question at a time.
15+
- Do not invent requirements.
16+
17+
## Workflow
18+
1. State the missing decision and why it blocks progress.
19+
2. Offer concrete options when possible.
20+
3. Record the answer and continue the work.
21+
4. Produce a short brief/spec only when enough answers exist.
22+
23+
## Failure mode
24+
If the user declines to answer, proceed with explicit assumptions and label them.

0 commit comments

Comments
 (0)