You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
| Current state |Unreleased refactor (33 packages) on main; last stable is [v0.1.6](https://github.com/LightDevCoder/skills/releases/tag/v0.1.6) with 9 packages |
`v0.1.1` shipped five packages; `v0.1.2` added `recap` and `language-learning` (seven); `v0.1.3` migrated the test toolchain; `v0.1.4` added `kanban-worker`; `v0.1.5` tightened kanban scheduling and identity; `v0.1.6` added `kb-init`. The current branch adds the remaining 24 packages for a 33-package architecture (see [CHANGELOG.md](CHANGELOG.md) unreleased).
19
+
`v0.1.1` shipped five packages; `v0.1.2` added `recap` and `language-learning` (seven); `v0.1.3` migrated the test toolchain; `v0.1.4` added `kanban-worker`; `v0.1.5` tightened kanban scheduling and identity; `v0.1.6` added `kb-init` (nine). `v0.2.0` released the full 33-package architecture across project workflow, clarification, execution, review, and specialized tools (see [CHANGELOG.md](CHANGELOG.md)).
20
20
21
21
No package in this table is an unmodified upstream copy. Approved Matt PORTs carry `ATTRIBUTION.md` and no upstream runtime dependency.
Copy file name to clipboardExpand all lines: CHANGELOG.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
5
5
All notable changes are recorded here. A release entry must be tied to an actual version or tag and must not be created merely because a document was drafted.
Copy file name to clipboardExpand all lines: README.md
+59-69Lines changed: 59 additions & 69 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,60 +4,60 @@
4
4
5
5
# Light Skills — Composable Agent Workflows
6
6
7
-
`LightDevCoder/skills`is a **first-party, general-purpose, composable Agent workflow system** — 33 small, explicit, independently discoverable Skills that combine into a complete project flow or run standalone. Each package owns its `SKILL.md` contract; this README explains the repository.
7
+
`LightDevCoder/skills`provides 33 first-party Agent Skills designed to work together across project planning, coding, and review, or run individually on demand. Each package lives in `skills/<name>/` and defines its own behavior in `SKILL.md`.
8
8
9
-
> **About:**Light Skills — Drive your creativity. Small, composable, inspectable.
9
+
> **Release:**[v0.2.0](https://github.com/LightDevCoder/skills/releases/tag/v0.2.0) is published from commit `9c2572b` (tag `v0.2.0`) and is the current stable release with 33 first-party Skills.
10
10
11
-
> **Release:**[v0.1.6](https://github.com/LightDevCoder/skills/releases/tag/v0.1.6) is published from commit `e8c3589` (tag `v0.1.6`) and is the last published stable (9 packages). The current branch contains **33 first-party Skills** (unreleased refactor — see [CHANGELOG.md](CHANGELOG.md)). Skills are still installed with `npx skills add LightDevCoder/skills`.
11
+
## Overview
12
12
13
-
## What is Light Skills
13
+
The repository organizes capabilities into focused areas:
14
14
15
-
A workflow system, not a monolithic orchestrator. The repository provides composable capabilities across:
15
+
-**Project Workflow:** end-to-end delivery from project bootstrap to release.
16
+
-**Clarification & Research:** structured questions and primary-source investigation before building.
17
+
-**Execution:** bounded implementation tasks with host-aware execution planning.
18
+
-**Review:** read-only specialist checks and final project acceptance.
19
+
-**Specialized Workflows:** dedicated tooling for manuscripts, knowledge bases, language learning, and kanban boards.
20
+
-**Router:**`ask-light` inspects workspace state to suggest next steps.
16
21
17
-
-**Project Workflow** — from initialization to release
18
-
-**Clarification & Research** — decide before you build
19
-
-**Execution** — do bounded work with host-aware routing
20
-
-**Review** — from read-only findings to project acceptance
-**Router** — `ask-light` recommends the next step, then begins it after approval
23
-
24
-
Architecture decides *which capabilities exist and how they compose*; Skill-writing quality follows [Matt Pocock Skills](https://github.com/mattpocock/skills), and host-aware routing follows [Sol Advisor](https://github.com/DannyMac180/sol-advisor) — both as design references, not runtime dependencies.
22
+
Skills follow the progressive disclosure patterns of Matt Pocock Skills and the host-evidence inspection approach of Sol Advisor as design references without adding runtime dependencies.
Refresh the host, then confirm discovery without the source checkout. See [Installation](docs/INSTALLATION.md) for revision semantics, manual fallback, and fresh-install evidence.
45
+
See [Installation](docs/INSTALLATION.md) for scope options, manual file copying, and verification notes.
46
46
47
47
## Quick Start
48
48
49
49
```text
50
-
$ask-light next # you don't know what's next — get one recommendation and stop
51
-
$project-init # bootstrap stable Light project contracts from a preset
52
-
$clarify # one invocation → continuous clarification, no SPEC
53
-
$project-clarify # real project → inspect repo, then decide
54
-
$implement # one clear ticket in, one verified artifact out
55
-
$project-review # final acceptance: PASS / FAIL / BLOCKED
50
+
$ask-light next # Suggest the next appropriate Skill from current context
51
+
$project-init # Bootstrap project structure and tracker contracts
52
+
$clarify # Clarify requirements through targeted questions
53
+
$project-clarify # Clarify project decisions using repository context
54
+
$implement # Execute a ready ticket with verification
55
+
$project-review # Run final acceptance checks: PASS / FAIL / BLOCKED
56
56
```
57
57
58
-
## Main workflow
58
+
## Main Workflow
59
59
60
-
The recommended project flow (not a required pipeline — enter mid-stream when appropriate):
60
+
A typical project progresses through these stages, though you can start directly at any stage:
61
61
62
62
```text
63
63
project-init
@@ -75,38 +75,38 @@ project-review
75
75
release-workflow
76
76
```
77
77
78
-
-`project-init` — idempotent Light bootstrap with stable project/tracker contracts; no full clarification.
79
-
-`project-clarify → project-spec → project-tickets` — clarify decisions, freeze a SPEC, slice into tracer-bullet tickets.
clarify # Standalone brainstorming and clarification
88
+
implement # Implement a well-defined ticket directly
89
+
diagnosing-bugs → implement # Diagnose an issue, then apply the fix
90
+
release-workflow # Publish an approved release
91
+
$ask-light # Route unclear tasks to the right Skill
92
92
```
93
93
94
-
Full composition is in [docs/workflows/](docs/workflows/). Each `SKILL.md` stays the authority.
94
+
See [docs/workflows/](docs/workflows/) for full workflow guides.
95
95
96
-
## When you don't know what's next
96
+
## Finding the Right Skill
97
97
98
98
```text
99
99
$ask-light next
100
100
$ask-light workflow
101
101
```
102
102
103
-
`ask-light` is the **Light Workflow Router** — user-invoked and read-only. It resolves logical fit from the Light-owned 33-Skill map, verifies host availability separately, and returns *one* recommendation (or one bounded recipe) with source, reason, and host-appropriate invocation — then stops. It never installs, executes, or chains another user-invoked Skill.
103
+
`ask-light` is a read-only router. It evaluates your current workspace against the 33 Skills in the collection and recommends one relevant Skill or bounded sequence, explaining the rationale before you choose to invoke it.
104
104
105
105
See [ask-light](skills/ask-light/SKILL.md) and [docs/workflows/](docs/workflows/).
Full inventory — purpose, when to use, invocation, and package path for all 33 — is in [CATALOG.md](CATALOG.md). Do not duplicate full Skill contracts here.
119
-
120
-
## First-party catalog (summary)
121
-
122
-
33 admitted first-party Skills under `skills/`. Package contracts are the behavior authority.
118
+
See [CATALOG.md](CATALOG.md) for full descriptions, invocation modes, and package paths.
123
119
124
-
See [CATALOG.md](CATALOG.md) for the complete table.
120
+
## Provenance and Attribution
125
121
126
-
## Ownership and upstream boundaries
127
-
128
-
| Source state | Authority | Treatment here |
122
+
| Origin | Policy | Repository Treatment |
129
123
| --- | --- | --- |
130
-
| First-party |This repository and its admitted package contracts | Included under`skills/`. |
131
-
| Approved Port (Matt) |Original upstream + `ATTRIBUTION.md`+ Light integration | Self-contained here; no runtime install of Matt Skills required. |
132
-
|Direct upstream (other) | Original upstream repository | Install directly; do not copy unchanged Skill here. |
| Approved Port (Matt Pocock) |Upstream behavior preserved with `ATTRIBUTION.md`| Self-contained in `skills/<name>/` without upstream runtime dependencies. |
126
+
|Third-party unmodified | External upstream | Recommended for direct installation; not duplicated here. |
127
+
| Modified third-party |Managed in private `LightDevCoder/skills-3rdParty`|Retains full patches, licenses, and sync locks. |
128
+
|Retired standalone | Consolidated into collection|Documented with migration history in release records. |
135
129
136
-
Approved Matt PORTs in this repo (SPEC §14): `research`, `prototype`, `tdd`, `handoff`, `diagnosing-bugs`, `wizard`, `teach`, `wait-what`, `to-questionnaire`, `writing-for-agents`, `resolving-merge-conflicts`. Each has `ATTRIBUTION.md` and no upstream runtime dependency. Light main workflow does not require `mattpocock/skills` or `sol-advisor` at runtime.
130
+
Approved Matt Ports (11 packages): `research`, `prototype`, `tdd`, `handoff`, `diagnosing-bugs`, `wizard`, `teach`, `wait-what`, `to-questionnaire`, `writing-for-agents`, `resolving-merge-conflicts`. Each package contains `ATTRIBUTION.md` and runs without external runtime dependencies.
137
131
138
-
## Governance and evidence
132
+
## Documentation
139
133
140
-
-[Maintenance contract](AGENTS.md)
141
-
-[Skill admission](docs/SKILL_ADMISSION.md)
142
-
-[Maintenance and synchronization](docs/MAINTENANCE.md)
143
-
-[Installation and fresh-install verification](docs/INSTALLATION.md)
Header image: [Assets/header.png](Assets/header.png) (first line of this README). The editable legacy header remains at `skills/docs/assets/skills-header.svg` / `.png` with manifest `skills/docs/assets/skills-header.json` for package tests.
0 commit comments