@plurnk/plurnk-meta 1.6.1 → 1.8.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/CORPUS.md +5 -5
- package/DOGFOOD.md +2 -2
- package/PLURNK_PERSONALITY.md +0 -4
- package/README.md +1 -1
- package/SPEC.md +27 -11
- package/dist/index.d.ts +7 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -2
- package/dist/index.js.map +1 -1
- package/docs/worker.md +4 -0
- package/package.json +4 -1
- package/requirements.md +2 -3
- package/skills/find-skills/LICENSE +21 -0
- package/skills/find-skills/SKILL.md +124 -0
- package/docs/log.md +0 -27
- package/docs/questions.md +0 -8
package/CORPUS.md
CHANGED
|
@@ -8,13 +8,13 @@ Authored defaults published by `@plurnk/plurnk-meta` and consumed by
|
|
|
8
8
|
|
|
9
9
|
| Source | Consumer admission |
|
|
10
10
|
| ------------------------------- | ---------------------------------------------------------------------------- |
|
|
11
|
-
| `PLURNK_PERSONALITY.md` | Read before the first-run seed of user-owned
|
|
11
|
+
| `PLURNK_PERSONALITY.md` | Read before the first-run seed of the user-owned XDG config `AGENTS.md`. |
|
|
12
12
|
| `requirements.md` | Read for the compact Recap rendered last in every model packet. |
|
|
13
|
-
| `docs/
|
|
14
|
-
| `
|
|
13
|
+
| `docs/worker.md` | Read when registered built-in pull docs are materialized. |
|
|
14
|
+
| `skills/find-skills/SKILL.md` | Bundled Agent Skill admitted below project and user-global skills. |
|
|
15
15
|
|
|
16
|
-
Core materializes eligible pull docs at `worker://plurnk/
|
|
17
|
-
exposes them through the turn-0 `## FIND0 [+init,+
|
|
16
|
+
Core materializes eligible pull docs at `worker://plurnk/skills/plurnk/<name>.md` and
|
|
17
|
+
exposes them through the turn-0 `## FIND0 [+init,+skills] (worker://plurnk/skills/plurnk/*.md)` survey. Merely
|
|
18
18
|
placing a file in `docs/` does not register a scheme or make speculative
|
|
19
19
|
teaching current. Every listed source is a required package member; a missing
|
|
20
20
|
or failed read surfaces at the admission boundary rather than silently reducing
|
package/DOGFOOD.md
CHANGED
|
@@ -12,7 +12,7 @@ Invoke it with:
|
|
|
12
12
|
```sh
|
|
13
13
|
PLURNK_ACCEPTANCE_PROJECT_ROOT=/path/to/open-project-forest \
|
|
14
14
|
PLURNK_CLIENT_CHECKOUT=/path/to/open-client \
|
|
15
|
-
npm run readiness:metaproject -- --model <
|
|
15
|
+
npm run readiness:metaproject -- --model <selector> --requiem --preserve
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
Both paths are explicit preconditions. The runner never guesses a sibling
|
|
@@ -43,7 +43,7 @@ forensic digestion.
|
|
|
43
43
|
- Every default-installed optional provider resolvable from the daemon.
|
|
44
44
|
- An explicitly assembled open-project forest with its root `AGENTS.md`; shared
|
|
45
45
|
parent directories containing other organizations are not valid substitutes.
|
|
46
|
-
- One inexpensive capable model
|
|
46
|
+
- One inexpensive capable model selector and, optionally, one local smoke-test selector.
|
|
47
47
|
|
|
48
48
|
Missing preconditions are RED outcomes. The runner never silently skips a phase.
|
|
49
49
|
|
package/PLURNK_PERSONALITY.md
CHANGED
|
@@ -1,7 +1,3 @@
|
|
|
1
1
|
YOU SHOULD answer inquiries and exploratory questions without changing state unless the user also asks for action.
|
|
2
2
|
YOU SHOULD follow modern standards and conventions unless a product property requires otherwise.
|
|
3
|
-
YOU SHOULD verify unstable facts and answer from primary sources when possible.
|
|
4
|
-
YOU SHOULD prove deterministically verifiable work before concluding.
|
|
5
|
-
|
|
6
|
-
YOU MUST identify and track the prompt's completion conditions.
|
|
7
3
|
YOU MUST evaluate the prompt for decomposability, delegating distinct subtasks to WORKers or BARE requests.
|
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@ The plurnk metaproject layer, published — what the family shares that no singl
|
|
|
12
12
|
- `Meta.packageDirs(nodeModulesDir)` — scope-agnostic, symlink-aware enumeration across Node's ancestor resolution chain as `{ dir, name }` candidates; the nearest package name wins. Ordering and filtering are the caller's policy.
|
|
13
13
|
- `Meta.nearestNodeModules(fromDir)` — walk up to the nearest `node_modules` holding the ecosystem (witness: `@plurnk` scope); `null` when absent.
|
|
14
14
|
|
|
15
|
-
**The teaching corpus**: authored policy, a compact Recap, built-in scheme
|
|
15
|
+
**The teaching corpus**: authored policy, a compact Recap, and built-in scheme sources resolved from this installed package. Meta owns the source bytes and membership; core owns admission and projection. See [`CORPUS.md`](./CORPUS.md) and {§teaching-corpus}.
|
|
16
16
|
|
|
17
17
|
**Family tooling** grows here (scaffolders, meta bins) — the published surface of the metaproject's management layer.
|
|
18
18
|
|
package/SPEC.md
CHANGED
|
@@ -15,8 +15,7 @@ sources into a consuming package would create a second teaching owner.
|
|
|
15
15
|
| ------------------------------- | ---------- | -------------------------------------------------- | ------------------------------------------------------- |
|
|
16
16
|
| `PLURNK_PERSONALITY.md` | Required | First-run default operating policy | Policy bootstrap {§policy-sections} |
|
|
17
17
|
| `requirements.md` | Required | Default compact operational Recap | Per-packet user-slot footer {§requirements} |
|
|
18
|
-
| `docs/
|
|
19
|
-
| `docs/questions.md` | Required | Conditional operator-question reference prose | Enabled capability/teaching gate {§send-300-choices} |
|
|
18
|
+
| `docs/worker.md` | Required | Deep reference prose for the reserved worker scheme | Pull-doc materialization {§schemes-directory} |
|
|
20
19
|
|
|
21
20
|
Required is a package-membership statement, not unconditional packet
|
|
22
21
|
projection. Each source is read only at its consuming boundary; absence or an
|
|
@@ -26,12 +25,27 @@ members from filenames, or treat a missing required source as empty teaching.
|
|
|
26
25
|
|
|
27
26
|
A file in `docs/` does not declare a capability. A built-in scheme document is
|
|
28
27
|
eligible only when its basename matches a registered reserved scheme; plugin
|
|
29
|
-
documentation remains owned by that plugin's manifest.
|
|
30
|
-
|
|
31
|
-
ship as speculative teaching. Manifest `documentation` is deliberately
|
|
28
|
+
documentation remains owned by that plugin's manifest. Retired or
|
|
29
|
+
unregistered names do not ship as speculative teaching. Manifest `documentation` is deliberately
|
|
32
30
|
optional: an absent field contributes no pull doc, while a present field is the
|
|
33
31
|
fallback only when meta owns no source for that scheme name.
|
|
34
32
|
|
|
33
|
+
## §bundled-skills Published default Agent Skills
|
|
34
|
+
|
|
35
|
+
`BUNDLED_SKILLS` is the exact immutable membership of Plurnk-owned default
|
|
36
|
+
skills. Every member is a complete standard Agent Skills directory carried in
|
|
37
|
+
the package; adding a file elsewhere does not implicitly publish it. Core owns
|
|
38
|
+
the ordered project/global/bundled union and model-facing materialization at
|
|
39
|
+
{§skills-materialization}.
|
|
40
|
+
|
|
41
|
+
| Name | Source | Provenance |
|
|
42
|
+
|---|---|---|
|
|
43
|
+
| `find-skills` | `skills/find-skills/SKILL.md` | Adapted from `vercel-labs/skills` revision `435076e78988e1e6ec40d00b0b1d76bdbbc5419a`; adjacent MIT license retained. |
|
|
44
|
+
|
|
45
|
+
Bundled membership does not install into or mutate the user-owned universal
|
|
46
|
+
Agent Skills root. A lower-precedence bundled skill may be shadowed by the
|
|
47
|
+
same standard skill installed globally or in the project.
|
|
48
|
+
|
|
35
49
|
## §plugin-discovery Installed capability discovery
|
|
36
50
|
|
|
37
51
|
```mermaid
|
|
@@ -66,12 +80,14 @@ installed capabilities; they never manufacture package existence.
|
|
|
66
80
|
family. A package may declare multiple named capabilities inside its one
|
|
67
81
|
family-owned collection.
|
|
68
82
|
|
|
69
|
-
| `plurnk.kind`
|
|
70
|
-
|
|
|
71
|
-
| `"exec"`
|
|
72
|
-
| `"mimetype"`
|
|
73
|
-
| `"provider"`
|
|
74
|
-
| `"scheme"`
|
|
83
|
+
| `plurnk.kind` | Family-owned names |
|
|
84
|
+
| ----------------- | -------------------------------------------------------- |
|
|
85
|
+
| `"exec"` | `runtimes[]` |
|
|
86
|
+
| `"mimetype"` | `handlers[]` |
|
|
87
|
+
| `"provider"` | singular `name` |
|
|
88
|
+
| `"scheme"` | `schemes[]`; singular `name` is the one-scheme shorthand |
|
|
89
|
+
| `"http-materializer"` | `materializers[]` ({§http-materializer-plugins}) |
|
|
90
|
+
| `"module"` | singular `module` export subpath ({§module-discovery}) |
|
|
75
91
|
|
|
76
92
|
Coordinated capabilities spanning families use explicit daemon-module
|
|
77
93
|
composition ({§module-lifecycle}); a multi-kind manifest is not a parallel
|
package/dist/index.d.ts
CHANGED
|
@@ -2,7 +2,7 @@ export interface PackageCandidate {
|
|
|
2
2
|
dir: string;
|
|
3
3
|
name: string;
|
|
4
4
|
}
|
|
5
|
-
export type PluginKind = "exec" | "mimetype" | "provider" | "scheme";
|
|
5
|
+
export type PluginKind = "exec" | "mimetype" | "provider" | "scheme" | "http-materializer" | "module";
|
|
6
6
|
export type PluginAttributionDeclaration = string | string[];
|
|
7
7
|
export type PluginAttribution = readonly string[];
|
|
8
8
|
export type PackageAttributions = ReadonlyMap<string, PluginAttribution>;
|
|
@@ -17,16 +17,19 @@ export interface PluginAttributionContext {
|
|
|
17
17
|
export interface PluginAttributionSource {
|
|
18
18
|
attributions?(context: PluginAttributionContext): PluginAttributionDeclaration | null | undefined;
|
|
19
19
|
}
|
|
20
|
+
export declare const BUNDLED_SKILLS: Readonly<{
|
|
21
|
+
readonly "find-skills": "skills/find-skills/SKILL.md";
|
|
22
|
+
}>;
|
|
23
|
+
export type BundledSkillName = keyof typeof BUNDLED_SKILLS;
|
|
24
|
+
export type BundledSkillSource = (typeof BUNDLED_SKILLS)[BundledSkillName];
|
|
20
25
|
export declare const TEACHING_CORPUS: Readonly<{
|
|
21
26
|
readonly personality: "PLURNK_PERSONALITY.md";
|
|
22
27
|
readonly requirements: "requirements.md";
|
|
23
28
|
readonly schemeDocs: Readonly<{
|
|
24
|
-
readonly log: "docs/log.md";
|
|
25
29
|
readonly worker: "docs/worker.md";
|
|
26
30
|
}>;
|
|
27
|
-
readonly questions: "docs/questions.md";
|
|
28
31
|
}>;
|
|
29
|
-
export type TeachingCorpusSource = typeof TEACHING_CORPUS.personality | typeof TEACHING_CORPUS.requirements | (typeof TEACHING_CORPUS.schemeDocs)[keyof typeof TEACHING_CORPUS.schemeDocs]
|
|
32
|
+
export type TeachingCorpusSource = typeof TEACHING_CORPUS.personality | typeof TEACHING_CORPUS.requirements | (typeof TEACHING_CORPUS.schemeDocs)[keyof typeof TEACHING_CORPUS.schemeDocs];
|
|
30
33
|
export default class Meta {
|
|
31
34
|
#private;
|
|
32
35
|
static declaresKind(manifest: unknown, kind: PluginKind): boolean;
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,mBAAmB,GAAG,QAAQ,CAAC;AAItG,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACpC,YAAY,CAAC,CAAC,OAAO,EAAE,wBAAwB,GAAG,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC;CACrG;AAQD,eAAO,MAAM,cAAc;4BACR,6BAA6B;EACrC,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,gBAAgB,CAAC,CAAC;AAI3E,eAAO,MAAM,eAAe;0BACX,uBAAuB;2BACtB,iBAAiB;;yBAhBvB,gBAAgB;;EAmBjB,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAC1B,OAAO,eAAe,CAAC,WAAW,GAClC,OAAO,eAAe,CAAC,YAAY,GACnC,CAAC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,UAAU,CAAC,CAAA;AAMlF,MAAM,CAAC,OAAO,OAAO,IAAI;;IACrB,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAGhE;IAKD,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,OAAO,CAKpG;IAED,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAiBhF;IAKD,MAAM,CAAC,kBAAkB,CACrB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,wBAAwB,EACjC,WAAW,EAAE,MAAM,GACpB,iBAAiB,CAcnB;IAED,MAAM,CAAC,mBAAmB,CAAC,GAAG,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,iBAAiB,CAIpF;IAkCD,OAAa,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyB5E;IAED,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASxD;CACJ"}
|
package/dist/index.js
CHANGED
|
@@ -20,16 +20,19 @@ import { readdir } from "node:fs/promises";
|
|
|
20
20
|
import { existsSync } from "node:fs";
|
|
21
21
|
import path from "node:path";
|
|
22
22
|
const SCHEME_TEACHING = Object.freeze({
|
|
23
|
-
log: "docs/log.md",
|
|
24
23
|
worker: "docs/worker.md",
|
|
25
24
|
});
|
|
25
|
+
// {§bundled-skills} — exact package-owned default membership. These sources
|
|
26
|
+
// use Agent Skills format; core owns their admission and log projection.
|
|
27
|
+
export const BUNDLED_SKILLS = Object.freeze({
|
|
28
|
+
"find-skills": "skills/find-skills/SKILL.md",
|
|
29
|
+
});
|
|
26
30
|
// {§teaching-corpus} — the authored package membership is one exported fact;
|
|
27
31
|
// consumers decide when and where each required source is projected.
|
|
28
32
|
export const TEACHING_CORPUS = Object.freeze({
|
|
29
33
|
personality: "PLURNK_PERSONALITY.md",
|
|
30
34
|
requirements: "requirements.md",
|
|
31
35
|
schemeDocs: SCHEME_TEACHING,
|
|
32
|
-
questions: "docs/questions.md",
|
|
33
36
|
});
|
|
34
37
|
const RESERVED_ATTRIBUTION_PREFIX = "@plurnk/";
|
|
35
38
|
const EMPTY_ATTRIBUTION = Object.freeze([]);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,kFAAkF;AAClF,+EAA+E;AAC/E,4BAA4B;AAC5B,4EAA4E;AAC5E,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,6EAA6E;AAC7E,2CAA2C;AAC3C,8EAA8E;AAC9E,iFAAiF;AACjF,4EAA4E;AAC5E,kFAAkF;AAClF,mFAAmF;AACnF,+DAA+D;AAE/D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AA4B7B,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/docs/worker.md
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
# `worker://` — workers and their entries
|
|
2
2
|
|
|
3
|
+
## Summary
|
|
4
|
+
|
|
5
|
+
Coordinate workers and manage shared or private workspace entries.
|
|
6
|
+
|
|
3
7
|
Workers inhabit one workspace. `worker://<name>` addresses a named worker; `worker://~` is the
|
|
4
8
|
current-worker control sigil; `worker://~/path` addresses your private entries; `worker:///path`
|
|
5
9
|
addresses the shared commons.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plurnk/plurnk-meta",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.8.0",
|
|
4
4
|
"description": "The plurnk metaproject layer, published: plugin-membership primitives (the ONE trust rule, scope-agnostic symlink-aware enumeration, deployment-root resolution), the project teaching corpus (personality, Recap, scheme docs), and the home for family tooling.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -16,6 +16,7 @@
|
|
|
16
16
|
"CORPUS.md",
|
|
17
17
|
"PLURNK_PERSONALITY.md",
|
|
18
18
|
"requirements.md",
|
|
19
|
+
"skills/**/*",
|
|
19
20
|
"docs/**/*",
|
|
20
21
|
"DIVERGENCES.md"
|
|
21
22
|
],
|
|
@@ -28,6 +29,8 @@
|
|
|
28
29
|
"./package.json": "./package.json",
|
|
29
30
|
"./PLURNK_PERSONALITY.md": "./PLURNK_PERSONALITY.md",
|
|
30
31
|
"./requirements.md": "./requirements.md",
|
|
32
|
+
"./skills/*/SKILL.md": "./skills/*/SKILL.md",
|
|
33
|
+
"./skills/*/LICENSE": "./skills/*/LICENSE",
|
|
31
34
|
"./docs/*.md": "./docs/*.md"
|
|
32
35
|
},
|
|
33
36
|
"scripts": {
|
package/requirements.md
CHANGED
|
@@ -1,3 +1,2 @@
|
|
|
1
|
-
YOU MUST
|
|
2
|
-
YOU MUST
|
|
3
|
-
YOU MUST react and respond to the latest prompt listed under Active User Prompts.
|
|
1
|
+
YOU MUST begin every turn with `# PLAN0`.
|
|
2
|
+
YOU MUST end every turn with `## SEND0 [status code]`.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Vercel, Inc.
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: find-skills
|
|
3
|
+
description: Helps users discover and install agent skills when they ask how to do something, request a skill, or want to extend agent capabilities.
|
|
4
|
+
license: MIT (see LICENSE)
|
|
5
|
+
metadata:
|
|
6
|
+
upstream: https://github.com/vercel-labs/skills/tree/435076e78988e1e6ec40d00b0b1d76bdbbc5419a/skills/find-skills
|
|
7
|
+
revision: "435076e78988e1e6ec40d00b0b1d76bdbbc5419a"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Find Skills
|
|
11
|
+
|
|
12
|
+
This skill helps you discover and install skills from the open Agent Skills ecosystem.
|
|
13
|
+
|
|
14
|
+
## When to Use This Skill
|
|
15
|
+
|
|
16
|
+
Use this skill when the user:
|
|
17
|
+
|
|
18
|
+
- Asks "how do I do X" where X might be a common task with an existing skill
|
|
19
|
+
- Says "find a skill for X" or "is there a skill for X"
|
|
20
|
+
- Asks "can you do X" where X is a specialized capability
|
|
21
|
+
- Expresses interest in extending agent capabilities
|
|
22
|
+
- Wants to search for tools, templates, or workflows
|
|
23
|
+
- Mentions they wish they had help with a specific domain
|
|
24
|
+
|
|
25
|
+
## What is the Skills CLI?
|
|
26
|
+
|
|
27
|
+
The Skills CLI (`npx skills`) is the package manager for the open Agent Skills ecosystem.
|
|
28
|
+
|
|
29
|
+
Key commands:
|
|
30
|
+
|
|
31
|
+
- `npx skills find [query] [--owner <owner>]` searches by keyword and can scope to a GitHub owner.
|
|
32
|
+
- `npx skills add <package> --agent universal` installs into the standard universal project path.
|
|
33
|
+
- `npx skills add <package> --agent universal --global` installs into the shared user-global path.
|
|
34
|
+
- `npx skills update` updates installed skills.
|
|
35
|
+
|
|
36
|
+
Browse skills at <https://skills.sh/>.
|
|
37
|
+
|
|
38
|
+
## Find a Skill
|
|
39
|
+
|
|
40
|
+
### 1. Understand the Need
|
|
41
|
+
|
|
42
|
+
Identify:
|
|
43
|
+
|
|
44
|
+
1. The domain, such as testing, design, deployment, or documentation.
|
|
45
|
+
2. The specific task, such as reviewing pull requests or creating a changelog.
|
|
46
|
+
3. Whether the task is common enough that a reusable skill likely exists.
|
|
47
|
+
|
|
48
|
+
### 2. Check Established Options
|
|
49
|
+
|
|
50
|
+
Check the [skills.sh leaderboard](https://skills.sh/) for a well-known skill in the domain. It ranks skills by installs and can surface established options before a broad search.
|
|
51
|
+
|
|
52
|
+
### 3. Search
|
|
53
|
+
|
|
54
|
+
Run:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
npx skills find [query] [--owner <owner>]
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Examples:
|
|
61
|
+
|
|
62
|
+
- React performance: `npx skills find react performance`
|
|
63
|
+
- Pull-request reviews: `npx skills find pr review`
|
|
64
|
+
- Changelog creation: `npx skills find changelog`
|
|
65
|
+
|
|
66
|
+
### 4. Verify Before Recommending
|
|
67
|
+
|
|
68
|
+
Do not recommend a skill solely because it appeared in search results. Consider:
|
|
69
|
+
|
|
70
|
+
1. Install count and evidence of real use.
|
|
71
|
+
2. Source reputation and ownership.
|
|
72
|
+
3. Repository activity, reviewability, and licensing.
|
|
73
|
+
4. The skill's actual `SKILL.md`, scripts, permissions, and dependencies.
|
|
74
|
+
|
|
75
|
+
### 5. Present Options
|
|
76
|
+
|
|
77
|
+
For each useful candidate, provide:
|
|
78
|
+
|
|
79
|
+
1. Its name and purpose.
|
|
80
|
+
2. Its source and relevant adoption evidence.
|
|
81
|
+
3. The exact install command.
|
|
82
|
+
4. Its skills.sh or source link.
|
|
83
|
+
|
|
84
|
+
### 6. Install Only With User Approval
|
|
85
|
+
|
|
86
|
+
Project installation is the default:
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
npx skills add <owner/repo@skill> --agent universal --yes
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Use a global installation only when the user explicitly wants the skill shared across compatible agents:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
npx skills add <owner/repo@skill> --agent universal --global --yes
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
The global universal directory is shared user state. Never install there merely because Plurnk bundles this discovery skill.
|
|
99
|
+
|
|
100
|
+
## Common Search Categories
|
|
101
|
+
|
|
102
|
+
| Category | Example queries |
|
|
103
|
+
|---|---|
|
|
104
|
+
| Web development | `react`, `nextjs`, `typescript`, `css`, `tailwind` |
|
|
105
|
+
| Testing | `testing`, `playwright`, `e2e` |
|
|
106
|
+
| DevOps | `deploy`, `docker`, `kubernetes`, `ci-cd` |
|
|
107
|
+
| Documentation | `docs`, `readme`, `changelog`, `api-docs` |
|
|
108
|
+
| Code quality | `review`, `lint`, `refactor`, `best-practices` |
|
|
109
|
+
| Design | `ui`, `ux`, `design-system`, `accessibility` |
|
|
110
|
+
| Productivity | `workflow`, `automation`, `git` |
|
|
111
|
+
|
|
112
|
+
## Search Tips
|
|
113
|
+
|
|
114
|
+
1. Prefer specific phrases: `react testing` is better than `testing`.
|
|
115
|
+
2. Try nearby terms when the first query misses: `deploy`, `deployment`, or `ci-cd`.
|
|
116
|
+
3. Check established sources, then inspect the actual skill before recommending it.
|
|
117
|
+
|
|
118
|
+
## When No Skill Fits
|
|
119
|
+
|
|
120
|
+
Say that the search found no suitable skill and offer to help directly. If the need is recurring, suggest creating a standard skill with:
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
npx skills init my-skill
|
|
124
|
+
```
|
package/docs/log.md
DELETED
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
# `log://` - your worker's event history
|
|
2
|
-
|
|
3
|
-
Every operation is recorded at `log:///<loop>/<turn>/<seq>`. The row identifies what happened and what came back. READ one exact row to retrieve its result body; use FIND to match across rows.
|
|
4
|
-
|
|
5
|
-
## Log and catalog
|
|
6
|
-
|
|
7
|
-
- **Log** - operations and results in order.
|
|
8
|
-
- **Catalog** - `## FIND0 (scheme:///**)` lists the resources a scheme currently holds.
|
|
9
|
-
|
|
10
|
-
## Visibility
|
|
11
|
-
|
|
12
|
-
- **FOLD** hides an open row's body. The row and body persist, and the row remains listed.
|
|
13
|
-
- **OPEN** reveals a folded row's body.
|
|
14
|
-
- A row's `tokens` is the size of its body: its current packet weight when open and its OPEN cost when folded.
|
|
15
|
-
|
|
16
|
-
OPEN and FOLD change packet visibility, not history. Applying the current state again or targeting a bodyless row is a successful no-op.
|
|
17
|
-
|
|
18
|
-
## Deletion and capacity
|
|
19
|
-
|
|
20
|
-
KILL permanently erases a log row.
|
|
21
|
-
|
|
22
|
-
The Budget section reports the packet ceiling, usage, percentage, and free capacity; negative
|
|
23
|
-
free capacity adds one curation alarm. Each log row exposes its curation weight as `tokens`. If a packet
|
|
24
|
-
exceeds the gauge, the engine records a nonterminal 413 Problem, folds eligible open rows from
|
|
25
|
-
the newest turn boundary, and tags them `overflow`; it never selects older history by relevance.
|
|
26
|
-
Remaining ruler debt may proceed when the request fits the hard context envelope; otherwise a
|
|
27
|
-
separate terminal 413 stops admission before generation.
|
package/docs/questions.md
DELETED
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
# Operator questions — SEND signal 300
|
|
2
|
-
|
|
3
|
-
Enabled here: you may ask the operator when a decision is genuinely theirs to
|
|
4
|
-
make. `## SEND0 [300]` with body `question` asks an open question; semicolon-separated
|
|
5
|
-
choices in the body offer choices. Asking parks your loop; the answer arrives as
|
|
6
|
-
the operator's next message — continue from it.
|
|
7
|
-
|
|
8
|
-
Choices are suggestions, never a constraint: the operator always has a free-text option regardless of what you list, so be ready for an answer outside your choices. Ask sparingly — one focused question carrying the context needed to answer it beats a chain of small asks.
|