@kmugalkhod/lightcode 0.5.0 → 0.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 (4) hide show
  1. package/README.md +28 -0
  2. package/cli.js +2083 -1115
  3. package/package.json +1 -1
  4. package/server.js +571 -316
package/README.md CHANGED
@@ -82,6 +82,34 @@ extractive fallback when the model is unreachable). The full conversation is
82
82
  always preserved in SQLite — compaction only changes what the model sees.
83
83
  Use `/compact` in a chat to compact manually.
84
84
 
85
+ ## Skills
86
+
87
+ Skills are reusable instruction files the agent can load on demand — a recipe
88
+ for a recurring task (writing a PR description, cutting a release, following a
89
+ review checklist). Each skill is a `SKILL.md` file with frontmatter:
90
+
91
+ ```markdown
92
+ ---
93
+ name: pr-description
94
+ description: Write a clear PR title and description from the diff.
95
+ ---
96
+
97
+ # Instructions the agent follows when this skill is loaded…
98
+ ```
99
+
100
+ Lightcode discovers skills from three locations, first match wins (project
101
+ overrides user):
102
+
103
+ 1. `.lightcode/skills/<name>/SKILL.md` — project-local
104
+ 2. `.agents/skills/<name>/SKILL.md` — project-local (fallback)
105
+ 3. `~/.lightcode/skills/<name>/SKILL.md` — available in every project
106
+
107
+ Each turn the agent is told which skills are available (name + description), so
108
+ just ask it to "use the pr-description skill" (or mention the skill by name) and
109
+ it loads the instructions via the `skill` tool and follows them. Run `/skills`
110
+ in the TUI to list what's installed. Only simple `key: value` frontmatter lines
111
+ are parsed (`name`, `description`); the rest of the file is the instruction body.
112
+
85
113
  ## Workspaces
86
114
 
87
115
  - `apps/cli` — OpenTUI React terminal interface