@csark0812/skeleton 3.0.0 → 4.0.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.
- package/README.md +6 -5
- package/dist/cli.js +531 -716
- package/dist/hooks/customize-on-skill-read.js +416 -126
- package/package.json +2 -2
- package/dist/references/check.d.ts +0 -10
- package/dist/references/constants.d.ts +0 -9
- package/dist/references/discover.d.ts +0 -19
package/README.md
CHANGED
|
@@ -2,15 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
<!-- source-of-truth: Package overview -->
|
|
4
4
|
|
|
5
|
-
<!-- doc-meta: owner=eng | last-reviewed=2026-
|
|
5
|
+
<!-- doc-meta: owner=eng | last-reviewed=2026-09-02 -->
|
|
6
6
|
|
|
7
7
|
<!-- review-deps: paths=src/cli.ts,package.json -->
|
|
8
8
|
|
|
9
9
|
Agent repos get messy fast. Skills get copied around, docs disagree, links go stale, and nobody remembers which file is actually canonical.
|
|
10
10
|
|
|
11
|
-
Skeleton is an SSOT linter for that layer. Define the contract once; Skeleton checks it locally and in CI. If a canonical doc disappears, SSOT markers drift, a skill index stops matching disk, or a
|
|
11
|
+
Skeleton is an SSOT linter for that layer. Define the contract once; Skeleton checks it locally and in CI. If a canonical doc disappears, SSOT markers drift, a skill index stops matching disk, or a local link breaks, the audit fails before merge.
|
|
12
12
|
|
|
13
|
-
Think ESLint — for the docs and skills your agents rely on. Primary CLI from `src/cli.ts`: `audit`, `validate`, `catalog`, `init`, `build-plugin
|
|
13
|
+
Think ESLint — for the docs and skills your agents rely on. Primary CLI from `src/cli.ts`: `audit`, `validate`, `catalog`, `init`, and `build-plugin` (plus `customize` / `hook` when using overlays). Commands dispatch through that entry file.
|
|
14
14
|
|
|
15
15
|
Skeleton is **not** a runtime agent harness. It doesn't execute tools, enforce permissions, or manage memory. It checks whether the repo around those systems still holds together.
|
|
16
16
|
|
|
@@ -106,6 +106,8 @@ Flag details: [install](docs/developer/install.md).
|
|
|
106
106
|
|
|
107
107
|
Agents skim `.skeleton/catalog.md` (generated, gitignored) before opening full papers.
|
|
108
108
|
|
|
109
|
+
Shared reference files can live in any scanned path. Public repositories can link skills directly to GitHub-hosted references; Skeleton leaves those external links unchanged and does not check their remote reachability.
|
|
110
|
+
|
|
109
111
|
Skeleton doesn't replace your code gates. Keep TypeScript, Python, Nx, pytest, and the rest in the repo that owns them.
|
|
110
112
|
|
|
111
113
|
## The contract
|
|
@@ -147,7 +149,6 @@ skeleton audit docs|skills|self [--strict] [--json] [--paths=a,b] [--fix[=doc-me
|
|
|
147
149
|
skeleton audit docs --paths=docs/a.md --fix=doc-meta --confirm-reviewed
|
|
148
150
|
skeleton build-plugin [path] [--check]
|
|
149
151
|
skeleton validate changed [--staged | --base <ref>] [paths…]
|
|
150
|
-
skeleton references sync|check
|
|
151
152
|
skeleton customize resolve <slug>
|
|
152
153
|
```
|
|
153
154
|
|
|
@@ -176,7 +177,7 @@ CI: `skeleton validate changed --base origin/main` (global rules first, then cha
|
|
|
176
177
|
|
|
177
178
|
Skeleton never calls Nx or another app task runner. Consumer repos keep ownership of test, typecheck, and build.
|
|
178
179
|
|
|
179
|
-
See [tiers](docs/tiers.md).
|
|
180
|
+
See [tiers](docs/tiers.md). Related work: [Toolbox](https://github.com/csark0812/toolbox) packages portable process skills, and [Christopher's profile](https://github.com/csark0812) connects the broader builder story.
|
|
180
181
|
|
|
181
182
|
## Docs
|
|
182
183
|
|