@plurnk/plurnk-meta 1.8.0 → 1.9.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 +2 -3
- package/PLURNK_PERSONALITY.md +2 -2
- package/SPEC.md +8 -15
- package/dist/index.d.ts +0 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +0 -5
- package/dist/index.js.map +1 -1
- package/package.json +1 -4
- package/skills/find-skills/LICENSE +0 -21
- package/skills/find-skills/SKILL.md +0 -124
package/CORPUS.md
CHANGED
|
@@ -11,10 +11,9 @@ Authored defaults published by `@plurnk/plurnk-meta` and consumed by
|
|
|
11
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
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
14
|
|
|
16
|
-
Core materializes eligible pull docs at `worker
|
|
17
|
-
exposes them through the turn-0 `## FIND0 [+init,+skills] (worker
|
|
15
|
+
Core materializes eligible pull docs at `worker://~/_plurnk/skills/plurnk/<name>.md` and
|
|
16
|
+
exposes them through the turn-0 `## FIND0 [+init,+skills] (worker://~/_plurnk/skills/plurnk/*.md)` survey. Merely
|
|
18
17
|
placing a file in `docs/` does not register a scheme or make speculative
|
|
19
18
|
teaching current. Every listed source is a required package member; a missing
|
|
20
19
|
or failed read surfaces at the admission boundary rather than silently reducing
|
package/PLURNK_PERSONALITY.md
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
YOU SHOULD answer inquiries and exploratory questions without changing state unless the user also asks for action.
|
|
2
|
-
YOU SHOULD
|
|
3
|
-
YOU
|
|
2
|
+
YOU SHOULD compose user-facing responses as markdown — mermaid, tables, lists, and/or prose as the content warrants.
|
|
3
|
+
YOU SHOULD decompose distinct subtasks into separate WORKers.
|
package/SPEC.md
CHANGED
|
@@ -30,21 +30,14 @@ unregistered names do not ship as speculative teaching. Manifest `documentation`
|
|
|
30
30
|
optional: an absent field contributes no pull doc, while a present field is the
|
|
31
31
|
fallback only when meta owns no source for that scheme name.
|
|
32
32
|
|
|
33
|
-
## §bundled-skills
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
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.
|
|
33
|
+
## §no-bundled-skills No package-bundled Agent Skills
|
|
34
|
+
|
|
35
|
+
Meta publishes no Agent Skills of its own. Skill discovery, installation, and
|
|
36
|
+
enablement are the Worker's `skills` Functionality family in core
|
|
37
|
+
({§skills-functionality}); the model learns that family from its generated
|
|
38
|
+
manager document, never from a bundled skill that teaches a shell package
|
|
39
|
+
manager. Standard skills reach a Worker only from the universal project and
|
|
40
|
+
user-global roots.
|
|
48
41
|
|
|
49
42
|
## §plugin-discovery Installed capability discovery
|
|
50
43
|
|
package/dist/index.d.ts
CHANGED
|
@@ -17,11 +17,6 @@ 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];
|
|
25
20
|
export declare const TEACHING_CORPUS: Readonly<{
|
|
26
21
|
readonly personality: "PLURNK_PERSONALITY.md";
|
|
27
22
|
readonly requirements: "requirements.md";
|
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,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,
|
|
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,eAAe;0BACX,uBAAuB;2BACtB,iBAAiB;;yBAPvB,gBAAgB;;EAUjB,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
|
@@ -22,11 +22,6 @@ import path from "node:path";
|
|
|
22
22
|
const SCHEME_TEACHING = Object.freeze({
|
|
23
23
|
worker: "docs/worker.md",
|
|
24
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
|
-
});
|
|
30
25
|
// {§teaching-corpus} — the authored package membership is one exported fact;
|
|
31
26
|
// consumers decide when and where each required source is projected.
|
|
32
27
|
export const TEACHING_CORPUS = 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,MAAM,EAAE,gBAAgB;CAClB,CAAC,CAAC;AAEZ,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plurnk/plurnk-meta",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.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,7 +16,6 @@
|
|
|
16
16
|
"CORPUS.md",
|
|
17
17
|
"PLURNK_PERSONALITY.md",
|
|
18
18
|
"requirements.md",
|
|
19
|
-
"skills/**/*",
|
|
20
19
|
"docs/**/*",
|
|
21
20
|
"DIVERGENCES.md"
|
|
22
21
|
],
|
|
@@ -29,8 +28,6 @@
|
|
|
29
28
|
"./package.json": "./package.json",
|
|
30
29
|
"./PLURNK_PERSONALITY.md": "./PLURNK_PERSONALITY.md",
|
|
31
30
|
"./requirements.md": "./requirements.md",
|
|
32
|
-
"./skills/*/SKILL.md": "./skills/*/SKILL.md",
|
|
33
|
-
"./skills/*/LICENSE": "./skills/*/LICENSE",
|
|
34
31
|
"./docs/*.md": "./docs/*.md"
|
|
35
32
|
},
|
|
36
33
|
"scripts": {
|
|
@@ -1,21 +0,0 @@
|
|
|
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.
|
|
@@ -1,124 +0,0 @@
|
|
|
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
|
-
```
|