中文说明

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.

Release: v0.2.0 is published from commit 9c2572b (tag v0.2.0) and is the current stable release with 33 first-party Skills.

The repository organizes capabilities into focused areas:

• Project Workflow: end-to-end delivery from project bootstrap to release.
• Clarification & Research: structured questions and primary-source investigation before building.
• Execution: bounded implementation tasks with host-aware execution planning.
• Review: read-only specialist checks and final project acceptance.
• Specialized Workflows: dedicated tooling for manuscripts, knowledge bases, language learning, and kanban boards.
• Router: ask-light inspects workspace state to suggest next steps.

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.

Install Light Skills using the interactive Skills CLI:

npx skills add LightDevCoder/skills

Install a single Skill:

npx skills add LightDevCoder/skills --skill project-review
npx skills add LightDevCoder/skills --skill research

Pin to the v0.2.0 release:

npx skills add LightDevCoder/skills#v0.2.0

Target a specific Agent directly:

npx skills add LightDevCoder/skills --agent claude-code

See Installation for advanced options (explicit agent targets, copy mode, non-interactive CI flags), manual file copying, and verification notes.

$ask-light next        # Suggest the next appropriate Skill from current context
$project-init          # Bootstrap project structure and tracker contracts
$clarify               # Clarify requirements through targeted questions
$project-clarify       # Clarify project decisions using repository context
$implement             # Execute a ready ticket with verification
$project-review        # Run final acceptance checks: PASS / FAIL / BLOCKED

A typical project progresses through these stages, though you can start directly at any stage:

project-init
      ↓
project-clarify
      ↓
project-spec
      ↓
project-tickets
      ↓
implement
      ↓
project-review
      ↓
release-workflow

• project-init: sets up tracker contracts and initial configuration.
• project-clarify → project-spec → project-tickets: clarifies requirements, writes the specification, and splits work into executable tickets.
• implement: implements one ticket at a time with automated checks.
• project-review: verifies quality against frozen baselines; review-loop handles iterative fixes.
• release-workflow: runs release validation, tagging, and publication.

Direct paths for common tasks:

clarify                          # Standalone brainstorming and clarification
implement                        # Implement a well-defined ticket directly
diagnosing-bugs → implement      # Diagnose an issue, then apply the fix
release-workflow                 # Publish an approved release
$ask-light                       # Route unclear tasks to the right Skill

See docs/workflows/ for full workflow guides.

$ask-light next
$ask-light workflow

ask-light is the Light workflow advisor, navigator, and router. It inspects project and workflow evidence, reasons about the best next Skill, explains why, and waits for approval before a validated host-aware transition (model-invoked targets may begin where supported; user-invoked targets fall back to rendering the exact invocation when direct Host transition is unavailable).

See ask-light and docs/workflows/.

See CATALOG.md for full descriptions, invocation modes, and package paths.

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.

• Maintenance Contract
• Skill Admission Policy
• Maintenance and Synchronization
• Installation Guide
• Review Policy · Reviewer Contract
• Catalog · Changelog
• Workflow Guides
• Release Receipt
• Collection Discovery Tests · Composition Tests