中文说明

Personal Skills Collection

LightDevCoder/skills is the public, first-party home for nine installable Agent Skills on the current branch (published in v0.1.6). Each package is independently discoverable, explicit about its invocation boundary, and small enough to inspect before use.

About: Personal Skills Collection — Drive your creativity

Release: v0.1.6 is published from commit e8c3589 (tag v0.1.6). The release record and fresh-install evidence live in docs/evidence/releases/v0.1.6/; post-release verification is recorded on main and linked from the GitHub Release.

kb-init was admitted through the full admission path with an independent review-loop agent-skill PASS; see its admission evidence. v0.1.6 publishes the nine-package collection. Independent acceptance for the original five packages remains BLOCKED; see the release receipts for the exact boundary.

Quick Start

Install the published first-party collection:

npx skills add LightDevCoder/skills --yes --copy --agent '*'

Install one Skill at the same published revision:

npx skills add LightDevCoder/skills --skill review-loop --yes --copy --agent '*'

Refresh the Agent host, then confirm that the package is visible in its Skill catalog. If the host exposes a filesystem, inspect the installed package's SKILL.md and agents/openai.yaml; discovery without the source checkout is the meaningful check. The exact CLI version, destination, and result are in INSTALLATION_VERIFICATION.md.

The first useful entry point when the next move is unclear is $ask-light:

$ask-light next

Four short examples:

$ask-light next       # recommend one next Skill; do not invoke it
$project-init         # initialize a confirmed minimal project preset
$recap                # summarize the current session in one line
$review-loop init     # freeze an already-approved acceptance baseline

ask-light is the only router in these examples. It reports a recommendation or a bounded recipe and stops; it never invokes, installs, or orchestrates the result. Read Quick Start, the Skill user guides, and workflow recipes for inputs, outputs, handoffs, and stopping boundaries.

For scheduled Light-Kanban work, kanban-worker turns each agent wake-up into one handled board task (renamed from light-kanban-worker in v0.1.6):

Use kanban-worker to process at most one Light-Kanban task.

It resumes owned work and review feedback before claiming new tasks, then returns the result for human confirmation. First registration needs the Agent ID, Name, and Avatar; later runs reuse the saved identity. Configure the scheduler so only one run of the same agent id can be active at a time (different agent ids may run concurrently). See the kanban-worker guide.

External capabilities

The published v0.1.6 collection contains nine first-party packages: the v0.1.2 release's seven (v0.1.1's five plus recap and language-learning; v0.1.3 kept the same seven and migrated the test toolchain), plus kanban-worker (renamed from light-kanban-worker), plus kb-init.

Optional workflow capabilities are external or third-party dependencies and are not included by default:

• grill-me / grilling — grill-me is the user-facing entry point for a one-session clarification interview; it starts the underlying model-invoked grilling capability. Treat them as one capability, not two workflow steps.
• research — investigate an external fact or practice when a local preset is insufficient.
• to-spec — turn an approved goal and constraints into a traceable specification.
• to-tickets — turn an approved specification into dependency-ordered tickets.
• implement — carry out one bounded, unblocked implementation ticket.
• code-review — provide specialist findings for a fixed change.
• handoff — preserve an accepted result or blocker for closeout or resumption.

These capabilities may come from mattpocock/skills or another external source. This repository does not copy them or install them automatically; check their availability before selecting a workflow that names them.

First-party catalog

Skill	Purpose	Invocation	Package
review-loop	Run bounded evidence, repair, and final-acceptance loops.	Model-invoked; manual entry point is supported.	skills/review-loop/
project-init	Initialize a confirmed software, manuscript, research, knowledge, data, or Skill-development project preset.	User-invoked only.	skills/project-init/
ask-light	Inspect the active host and recommend one appropriate next Skill or bounded recipe without executing it.	User-invoked only.	skills/ask-light/
kb-init	Design and initialize a maintainable knowledge base through a knowledge-base-specific interview and an approval-gated implementation SPEC.	User-invoked only.	skills/kb-init/
language-learning	Tutor for any target language through six study modes: lessons, flashcards, conversation, grammar, quizzes, and immersion.	User-invoked only.	skills/language-learning/
recap	Summarize the current Agent session in exactly one line without changing history or continuing the task.	User-invoked only.	skills/recap/
learn-anything	Distill sufficiently evidenced source material into reusable Agent Skill methods.	User-invoked only.	skills/learn-anything/
manuscript-ops	Govern reproducible manuscript engineering across formats, batches, reviews, and handoffs.	Model-invoked; manual entry point is supported.	skills/manuscript-ops/
kanban-worker	Pick up and execute one Light-Kanban task per scheduled run, then return it for human confirmation.	Model-invoked; manual entry point is supported.	skills/kanban-worker/

CATALOG.md is the human-readable inventory. Package-level SKILL.md files remain the behavior authority; the guides explain usage without creating a second contract.

Composition without a fixed workflow

The collection is composable rather than a required pipeline. Recipes in docs/workflows/ document explicit handoffs such as specification → tickets → implementation → specialist review → final review-loop verdict. They are documentation and validation assets, not an automatic orchestration engine and not a replacement for the retired project-workflow package.

Ownership and upstream boundaries

Source state	Authority	Treatment here
First-party	This repository and its admitted package contracts	Included under skills/.
Direct upstream	The original upstream repository	Install directly; do not copy an unchanged Skill here.
Modified third-party	The private LightDevCoder/skills-3rdParty repository	Keep provenance, patches, licenses, sync locks, and install evidence.
Deprecated or archived	The released migration record	Keep history and point users to the current authority.

Matt Pocock Skills that are not first-party remain at mattpocock/skills. The selected private third-party snapshot is maintained separately at LightDevCoder/skills-3rdParty and is never copied into this public collection.

Governance and evidence

• Maintenance contract
• Skill admission
• Maintenance and synchronization
• Installation and fresh-install verification
• Review policy
• Catalog
• Changelog
• Release receipt
• recap admission evidence
• language-learning admission evidence
• kanban-worker admission evidence
  (admission record predates the v0.1.6 rename from light-kanban-worker)
• kb-init admission evidence
• Collection discovery test