@pratikpsl/agent-skills 0.5.0 → 0.6.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 (3) hide show
  1. package/README.md +96 -58
  2. package/package.json +19 -3
  3. package/templates/dotnet/manifest.json +1 -1
package/README.md CHANGED
@@ -1,100 +1,138 @@
1
- # agent-skills
1
+ # @pratikpsl/agent-skills
2
2
 
3
- > Scaffold and manage AI agent skills across any project — like `shadcn/ui` but for AI coding agents.
3
+ > Scaffold and manage AI agent skills across any project — like `shadcn/ui`, but for Cursor, Claude, Codex, Copilot, and Antigravity.
4
4
 
5
- This single package `@pratikpsl/agent-skills` bundles both the CLI tool and the template definitions. This makes installation and publishing simple and ensures offline usage capability with zero network delays at runtime.
5
+ `@pratikpsl/agent-skills` is a single npm package: a TypeScript CLI plus bundled skill **packs** under `templates/`. No runtime network fetch — packs ship inside the package, so setup works offline after install.
6
+
7
+ Currently published on npm as **0.5.0**; this branch prepares **0.6.0**.
6
8
 
7
9
  ---
8
10
 
9
- ## Usage (Consumers)
11
+ ## Quickstart
10
12
 
11
- To setup agent skills in any target project, run:
13
+ From any project root (Node 18+):
12
14
 
13
15
  ```bash
14
- # In any .NET project root:
15
- npx @pratikpsl/agent-skills dotnet-setup
16
-
17
- # Install shared skills + one IDE entry-point only
18
- npx @pratikpsl/agent-skills dotnet-setup cursor # → .cursor/rules/instructions.md
19
- npx @pratikpsl/agent-skills dotnet-setup claude # → CLAUDE.md
20
- npx @pratikpsl/agent-skills dotnet-setup codex # → AGENTS.md
21
- npx @pratikpsl/agent-skills dotnet-setup copilot # → .github/copilot-instructions.md
22
- npx @pratikpsl/agent-skills dotnet-setup antigravity # → .agents/GEMINI.md
16
+ # Install the full .NET/C# skill set + every IDE entry-point
17
+ npx @pratikpsl/agent-skills@0.6.0 dotnet-setup
18
+
19
+ # Or install shared skills + one IDE entry-point only
20
+ npx @pratikpsl/agent-skills@0.6.0 dotnet-setup cursor # → .cursor/rules/instructions.md
21
+ npx @pratikpsl/agent-skills@0.6.0 dotnet-setup claude # → CLAUDE.md
22
+ npx @pratikpsl/agent-skills@0.6.0 dotnet-setup codex # → AGENTS.md
23
+ npx @pratikpsl/agent-skills@0.6.0 dotnet-setup copilot # → .github/copilot-instructions.md
24
+ npx @pratikpsl/agent-skills@0.6.0 dotnet-setup antigravity # → .agents/GEMINI.md
23
25
  ```
24
26
 
25
- ### Other Commands
27
+ Until 0.6.0 is published, use `@0.5.0` or the git branch for local testing.
28
+
29
+ ---
26
30
 
27
- | Command | Description |
28
- | ------------------------------------------------ | -------------------------------------------------------- |
29
- | `npx @pratikpsl/agent-skills init` | Scaffold an empty `AgentSkills/` folder and `index.json` |
30
- | `npx @pratikpsl/agent-skills list dotnet` | List available skills inside the dotnet pack |
31
- | `npx @pratikpsl/agent-skills add dotnet <skill>` | Copy a single skill into your project |
32
- | `npx @pratikpsl/agent-skills add dotnet --all` | Copy all skills (alternative to `dotnet-setup`) |
33
- | `npx @pratikpsl/agent-skills --help` | Show CLI help |
34
- | `npx @pratikpsl/agent-skills --version` | Show CLI version |
31
+ ## Commands
32
+
33
+ | Command | Description |
34
+ | --- | --- |
35
+ | `npx @pratikpsl/agent-skills init` | Scaffold an empty `AgentSkills/` folder and `index.json` |
36
+ | `npx @pratikpsl/agent-skills list` | List skills in known packs (default: `dotnet`) |
37
+ | `npx @pratikpsl/agent-skills list dotnet` | List skills in the `dotnet` pack |
38
+ | `npx @pratikpsl/agent-skills add dotnet <skill>` | Copy one skill into the project |
39
+ | `npx @pratikpsl/agent-skills add dotnet --all` | Copy all skills (same pack content as `dotnet-setup`) |
40
+ | `npx @pratikpsl/agent-skills dotnet-setup [ide]` | Convenience installer for the .NET pack |
41
+ | `npx @pratikpsl/agent-skills --help` | Show CLI help |
42
+ | `npx @pratikpsl/agent-skills --version` | Show CLI version |
35
43
 
36
44
  ### Options
37
45
 
38
- - `--force`: Overwrite existing skill and entry point files.
39
- - `--path <dir>`: Target project root (defaults to `process.cwd()`).
46
+ - `--force` — overwrite existing skill and entry-point files
47
+ - `--path <dir>` — target project root (default: `process.cwd()`)
48
+
49
+ ---
50
+
51
+ ## Packs
52
+
53
+ | Pack | Path | Notes |
54
+ | --- | --- | --- |
55
+ | `dotnet` | `templates/dotnet/` | .NET/C# skills, agents, memory, IDE entry-points |
56
+
57
+ Aliases accepted by the CLI: `dotnet`, `skills-dotnet`, `@pratikpsl/agent-skills-dotnet`.
58
+
59
+ The repo also contains a `Skills/` tree of additional drafts and a `plugins/` folder. Those are **not** part of the published npm tarball (see `.npmignore` and the `files` whitelist in `package.json`).
40
60
 
41
61
  ---
42
62
 
43
- ## Repository Structure
63
+ ## Repository layout
44
64
 
45
65
  ```
46
- agent-skills/
47
- ├── bin/
48
- │ └── agent-skills.js (CLI binary entrypoint)
66
+ coding-skills-ai/
49
67
  ├── src/
50
- │ ├── index.js (CLI commands setup)
51
- │ ├── commands/ (init, list, add, dotnet-setup)
52
- │ ├── lib/ (copySkills, manifest parsing, resolvePack)
53
- │ ├── templates/ (bundled language packs)
54
- │ │ └── dotnet/
55
- │ │ ├── AgentSkills/ (C# best practices, agents, memory, lessons)
56
- │ │ └── manifest.json (declaration of files and destinations)
57
- │ └── __tests__/ (unit test suite)
58
- ├── package.json (unified package configuration)
59
- ├── LICENSE (MIT)
68
+ │ ├── bin/agent-skills.ts # CLI binary entry
69
+ │ ├── cli/ # commander wiring + commands
70
+ │ │ └── commands/ # init, list, add, dotnet-setup
71
+ │ └── core/ # resolve-pack, manifest, copy-skills
72
+ ├── templates/
73
+ │ └── dotnet/ # shipped pack (manifest.json + AgentSkills/)
74
+ ├── tests/ # Vitest suite
75
+ ├── Skills/ # extra drafts (not published)
76
+ ├── plugins/ # local experiments (not published)
77
+ ├── .github/workflows/ # CI + npm publish on version tags
78
+ ├── package.json
79
+ ├── tsconfig.json # emits to dist/
80
+ ├── vitest.config.ts
81
+ ├── LICENSE # Apache-2.0
60
82
  └── README.md
61
83
  ```
62
84
 
85
+ Build output: `tsc` compiles `src/` → `dist/`. The published binary is `dist/bin/agent-skills.js`. Pack templates stay at package-root `templates/` (included via `files`).
86
+
63
87
  ---
64
88
 
65
- ## Local Development
89
+ ## Local development
66
90
 
67
91
  ```bash
68
- # Install dependencies
69
- npm install
70
-
71
- # Run unit tests
92
+ npm ci
93
+ npm run build
72
94
  npm test
73
95
 
74
- # Link CLI globally for local command line testing
96
+ # Optional: try the CLI globally from this checkout
75
97
  npm link
76
-
77
- # Test the linked binary inside any other project directory
78
- agent-skills dotnet-setup
98
+ agent-skills --help
99
+ agent-skills list dotnet
79
100
  ```
80
101
 
81
- ---
102
+ Useful scripts:
82
103
 
83
- ## Publishing to npm
104
+ | Script | What it does |
105
+ | --- | --- |
106
+ | `npm run build` | `tsc` → `dist/` |
107
+ | `npm test` | Vitest (`tests/**/*.test.ts`) |
108
+ | `npm run test:watch` | Vitest watch mode |
109
+ | `npm run dry-run` | Build + `npm publish --dry-run` |
84
110
 
85
- Since this is a unified package, publishing is straightforward:
111
+ ---
86
112
 
87
- 1. **Log in to npm** (if not already):
88
- ```bash
89
- npm login
90
- ```
91
- 2. **Publish the package**:
113
+ ## Publish checklist (maintainers)
114
+
115
+ 1. Ensure `main` is green (CI: Node 18/20/22 — build + test).
116
+ 2. Confirm version in `package.json` (and pack `templates/dotnet/manifest.json` if skill content changed).
117
+ 3. Verify the tarball includes templates:
92
118
  ```bash
93
- npm publish --otp=YOUR_6_DIGIT_OTP
119
+ npm run build
120
+ npm pack --dry-run
121
+ # Expect: dist/** and templates/dotnet/** (not Skills/ or src/)
94
122
  ```
123
+ 4. Publish:
124
+ - **Trusted Publisher (preferred):** push an annotated tag matching `package.json`, e.g. `v0.6.0`. Workflow `.github/workflows/publish.yml` runs tests and `npm publish --provenance`.
125
+ - **Manual:**
126
+ ```bash
127
+ npm login
128
+ npm run build && npm test
129
+ npm publish --access public --otp=YOUR_6_DIGIT_OTP
130
+ ```
131
+ 5. Confirm on npm: https://www.npmjs.com/package/@pratikpsl/agent-skills
132
+ 6. Smoke-test: `npx @pratikpsl/agent-skills@0.6.0 --version` and `dotnet-setup` in a throwaway folder.
95
133
 
96
134
  ---
97
135
 
98
136
  ## License
99
137
 
100
- MIT
138
+ Apache License 2.0 — see [`LICENSE`](./LICENSE).
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@pratikpsl/agent-skills",
3
3
  "type": "module",
4
- "version": "0.5.0",
5
- "description": "CLI to scaffold and manage AI agent skills across projects",
4
+ "version": "0.6.0",
5
+ "description": "CLI to scaffold and manage AI agent skills across projects — like shadcn/ui, but for Cursor, Claude, Codex, Copilot, and more",
6
6
  "bin": {
7
7
  "agent-skills": "dist/bin/agent-skills.js"
8
8
  },
@@ -15,10 +15,26 @@
15
15
  "engines": {
16
16
  "node": ">=18"
17
17
  },
18
+ "keywords": [
19
+ "ai",
20
+ "agent-skills",
21
+ "cursor",
22
+ "claude",
23
+ "cli",
24
+ "scaffold",
25
+ "copilot",
26
+ "codex",
27
+ "dotnet",
28
+ "agents"
29
+ ],
30
+ "homepage": "https://github.com/pratiksinghlad/coding-skills-ai#readme",
31
+ "bugs": {
32
+ "url": "https://github.com/pratiksinghlad/coding-skills-ai/issues"
33
+ },
18
34
  "publishConfig": {
19
35
  "access": "public"
20
36
  },
21
- "license": "MIT",
37
+ "license": "Apache-2.0",
22
38
  "repository": {
23
39
  "type": "git",
24
40
  "url": "git+https://github.com/pratiksinghlad/coding-skills-ai.git"
package/templates/dotnet/manifest.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pratikpsl/agent-skills-dotnet",
3
- "version": "0.5.0",
3
+ "version": "0.6.0",
4
4
  "description": "AI agent skill definitions for .NET/C# projects (CQRS, MediatR, EF Core, xUnit, ASP.NET Core).",
5
5
  "skills": [
6
6
  {