agentic-web-developer 1.0.1 → 1.0.2
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 +204 -128
- package/docs/INSTALL.md +149 -147
- package/docs/LICENSING.md +132 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,128 +1,204 @@
|
|
|
1
|
-
# agentic-web-developer
|
|
2
|
-
|
|
3
|
-
An **agentic skill** that turns an AI coding agent into a complete web-development and website-selling system
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
- **
|
|
14
|
-
- **
|
|
15
|
-
- **
|
|
16
|
-
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
1
|
+
# agentic-web-developer
|
|
2
|
+
|
|
3
|
+
An **agentic skill** that turns an AI coding agent into a complete web-development and website-selling system
|
|
4
|
+
|
|
5
|
+
Plus a **novel-idea / product-launch mode** for websites not covered by the videos (SaaS, products, marketplaces).
|
|
6
|
+
|
|
7
|
+
And a **Mode C** for advanced 3D / WebGL sites — cinematic Three.js builds in the style of Kage and Towers.
|
|
8
|
+
|
|
9
|
+
> **Licensed — Pro plan ($7/month).** The skill validates an Animotion **Pro key** (or staff admin credentials) once per session before doing any work. [](https://skills.animotion.click/checkout?plan=pro) [](https://skills.animotion.click/checkout?plan=studio) — payment steps, install-with-key commands and credential setup: **[License & unlocking](#license--unlocking-the-skill)** · full guide **[docs/LICENSING.md](docs/LICENSING.md)**.
|
|
10
|
+
|
|
11
|
+
## What you get
|
|
12
|
+
|
|
13
|
+
- **Stage-gated pipeline** (Intake → Niche → Research → Design → Build → QA → Animation handoff → Deploy → Sell) where the agent **asks for your input at every step** — it never runs ahead on assumptions.
|
|
14
|
+
- **Three modes** — Mode A build-and-sell, Mode B novel idea / product launch, Mode C advanced 3D / WebGL experience.
|
|
15
|
+
- **Design-tool agnostic** — Figma, Paper, Google Stitch, Google AI Studio, Framer or code-first. You supply the credentials/MCP for your tool of choice.
|
|
16
|
+
- **Framework agnostic** — Next.js, React, Vue, Svelte, Astro, plain HTML, WordPress, GoHighLevel — you pick.
|
|
17
|
+
- **All animation is delegated** to the [AnimotionJS agentic skill](https://skills.animotion.click/checkout) — this skill never writes animation code itself.
|
|
18
|
+
- 11 reference playbooks + 5 ready-to-fill templates (builder brief, scaffold HTML, `siteconfig.ts`, outlier anatomy, 3D scene brief).
|
|
19
|
+
|
|
20
|
+
## Install
|
|
21
|
+
|
|
22
|
+
Full guide (per-agent paths, manual install, uninstall): **[docs/INSTALL.md](docs/INSTALL.md)** — worked examples of both modes: **[docs/EXAMPLES.md](docs/EXAMPLES.md)**.
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
# auto-detect your agent (opencode → claude → any detected agent)
|
|
26
|
+
npx agentic-web-developer install
|
|
27
|
+
|
|
28
|
+
# or target one of the 15 supported agents
|
|
29
|
+
npx agentic-web-developer install --agent=opencode
|
|
30
|
+
npx agentic-web-developer install --agent=claude
|
|
31
|
+
|
|
32
|
+
# or install for every detected agent at once
|
|
33
|
+
npx agentic-web-developer install --all
|
|
34
|
+
|
|
35
|
+
# see what's installed where
|
|
36
|
+
npx agentic-web-developer detect
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Other flags: `--force` (overwrite), `--dry-run` (print targets only), `--dir=<path>` (custom destination), `--source=<url|path>` / `--token=<key>` (skill source).
|
|
40
|
+
|
|
41
|
+
Then **restart your AI agent** so it loads the skill.
|
|
42
|
+
|
|
43
|
+
> **On first run the skill asks for its Pro license key** (or admin credentials) and validates it once per session — see [License & unlocking](#license--unlocking-the-skill) before you start a project.
|
|
44
|
+
|
|
45
|
+
> **Where does the skill come from?** Not from npm — the package ships only the installer and docs. The installer fetches the skill from a source you configure (`--source`, `AWD_SOURCE`, or the author's `awd.source` in `package.json`). See [docs/INSTALL.md § Skill source](docs/INSTALL.md#skill-source).
|
|
46
|
+
|
|
47
|
+
### Supported agents
|
|
48
|
+
|
|
49
|
+
`opencode` · `claude` · `copilot` · `cursor` · `windsurf` · `codex` · `cline` · `roo` · `cody` · `codium` · `aider` · `continue` · `augment` · `amazonq` · `jetbrains`
|
|
50
|
+
|
|
51
|
+
The installer writes **each agent's own file format** with the right frontmatter — `SKILL.md` for skill agents, `skill.md` for Windsurf/Codium, `rules/*.mdc` for Cursor, `rules/*.md` for Continue/Augment/Amazon Q, `CONVENTIONS.md` for Aider — and puts the `references/` + `templates/` payload where that agent can read it. Same 15 agents as the AnimotionJS skill.
|
|
52
|
+
|
|
53
|
+
### Manual install (no CLI)
|
|
54
|
+
|
|
55
|
+
See **[docs/INSTALL.md](docs/INSTALL.md#manual-install-no-cli)** — per-agent copy instructions for all 15 agents.
|
|
56
|
+
|
|
57
|
+
## License & unlocking the skill
|
|
58
|
+
|
|
59
|
+
The skill ships behind the **Animotion Pro plan — $7/month**. One validation per session (cached 7 days) runs before any pipeline work; without it the skill refuses to start.
|
|
60
|
+
|
|
61
|
+
### How to pay for Pro
|
|
62
|
+
|
|
63
|
+
1. **Click a Get Pro button** (top of this README or above) — opens [`skills.animotion.click/checkout?plan=pro`](https://skills.animotion.click/checkout?plan=pro) with Pro preselected ($7/month). Studio ($15/month) also unlocks this skill *and* the AnimotionJS animation skill you need at Stage 8.
|
|
64
|
+
2. **Enter your email** — the license is tied to it.
|
|
65
|
+
3. **Continue to Payment** → Stripe's hosted checkout (card).
|
|
66
|
+
4. **Confirm** — monthly, cancel anytime.
|
|
67
|
+
5. **Copy your key** (`sec_live_…`) from the confirmation page.
|
|
68
|
+
|
|
69
|
+
### How to give the skill your key (or admin credentials)
|
|
70
|
+
|
|
71
|
+
Pick one — the gate looks for environment variables first, then the installer's config file, then asks you once:
|
|
72
|
+
|
|
73
|
+
**1. Install the AnimotionJS skill with your key (recommended — one command, everything wired)**
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
npx animotion-skills install --tier=agentic --agent=<your-agent> --license-key=YOUR_KEY
|
|
77
|
+
|
|
78
|
+
# or install for every detected agent at once:
|
|
79
|
+
npx animotion-skills install --tier=agentic --all --license-key=YOUR_KEY
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
With **admin credentials instead of a license key** (Animotion staff / whitelisted emails only):
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
npx animotion-skills install --tier=agentic --agent=<your-agent> --admin-email=you@example.com --admin-secret=YOUR_ADMIN_SECRET
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
`<your-agent>` is one of the [15 supported agents](#supported-agents) — `opencode`, `claude`, `copilot`, `cursor`, … This installs the AnimotionJS animation skill (you need it at Stage 8 anyway) **and** writes `animotion-config.json` next to it — the agentic-web-developer gate reads that file automatically, so nothing else to configure.
|
|
89
|
+
|
|
90
|
+
> Note: this installer's `agentic` tier requires the **Studio plan** ($15/month). If you're on **Pro only** ($7/month), use options 2–4 below instead — the gate itself accepts any active Pro key.
|
|
91
|
+
|
|
92
|
+
**2. Environment variable**
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
# bash / zsh — add to ~/.bashrc or ~/.zshrc
|
|
96
|
+
export AGENTIC_LICENSE_KEY="sec_live_xxxxxxxx"
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
```powershell
|
|
100
|
+
# PowerShell — persistent (open a new terminal afterwards)
|
|
101
|
+
setx AGENTIC_LICENSE_KEY "sec_live_xxxxxxxx"
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
`ANIMOTION_LICENSE_KEY` works as an alias — one variable serves this skill and the Animotion installer.
|
|
105
|
+
|
|
106
|
+
**3. `animotion-config.json` by hand** — same file the installer writes (gate search paths: the skill directory, its parent dir, `~/.animotion-skills/`, or the path in `AGENTIC_LICENSE_CONFIG`):
|
|
107
|
+
|
|
108
|
+
```json
|
|
109
|
+
{
|
|
110
|
+
"tier": "pro",
|
|
111
|
+
"requiredPlan": "pro",
|
|
112
|
+
"authMethod": "license",
|
|
113
|
+
"licenseKey": "sec_live_xxxxxxxx"
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
**4. Admin credentials via environment** (Animotion staff / whitelisted emails only) — `AGENTIC_ADMIN_EMAIL` + `AGENTIC_ADMIN_SECRET`. Never commit these; everyone else should use a personal Pro key.
|
|
118
|
+
|
|
119
|
+
**5. Ask in-session** — with nothing found, the skill asks once (via its question tool); paste the key and it validates immediately.
|
|
120
|
+
|
|
121
|
+
### What happens at runtime
|
|
122
|
+
|
|
123
|
+
The skill calls `POST https://skills.animotion.click/api/license/validate` with `{ "skill": "agentic-web-developer", "plan": "pro" }` and your key (or admin pair). On success the verdict is cached at `~/.animotion-skills/cache/agentic-web-developer-verdict.json` for 7 days; offline sessions reuse a fresh cache. Full troubleshooting (invalid key, wrong plan, expired cache, local dev server): **[docs/LICENSING.md](docs/LICENSING.md)**.
|
|
124
|
+
|
|
125
|
+
You can also download the skill files directly with your key or admin pair — copy-paste commands in [docs/LICENSING.md § Install the skill files](docs/LICENSING.md#install-the-skill-files-license-key-or-admin-credentials).
|
|
126
|
+
|
|
127
|
+
## Animations are a separate skill (required to finish a site)
|
|
128
|
+
|
|
129
|
+
Every website built with this skill gets its **animations and interactions from the AnimotionJS agentic skill** — hero reveals, scroll effects, hover states, counters, parallax, text FX. Install it too:
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
npx animotion-skills install --tier=agentic --agent=<your-agent> --license-key=YOUR_KEY
|
|
133
|
+
# or for all detected agents:
|
|
134
|
+
npx animotion-skills install --tier=agentic --all --license-key=YOUR_KEY
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
- License key (Studio plan, $15/month): https://skills.animotion.click/checkout
|
|
138
|
+
- Local source on the author's machine: `C:\Users\creat\Projects\Animotionjs\animotion-skills`
|
|
139
|
+
|
|
140
|
+
Without it, the skill will still design and build — but it will stop at Stage 8 and ask you to install Animotion before any motion work.
|
|
141
|
+
|
|
142
|
+
## Using the skill
|
|
143
|
+
|
|
144
|
+
Just talk to your agent:
|
|
145
|
+
|
|
146
|
+
> "Build me a website that converts for my pool cleaning business"
|
|
147
|
+
> "Launch a product website for my new SaaS idea"
|
|
148
|
+
> "Build me an immersive 3D website"
|
|
149
|
+
> "Use the agentic-web-developer skill"
|
|
150
|
+
|
|
151
|
+
The agent classifies the project (Mode A: build-and-sell, Mode B: novel idea, Mode C: advanced 3D/WebGL), then walks you through every gate.
|
|
152
|
+
|
|
153
|
+
## Project layout
|
|
154
|
+
|
|
155
|
+
```
|
|
156
|
+
agentic-web-developer/
|
|
157
|
+
├── package.json # npm manifest (bin: agentic-web-developer, awd.source)
|
|
158
|
+
├── bin/install.js # zero-dependency installer CLI (all 15 agents, per-agent formats)
|
|
159
|
+
├── skill/ # ← the skill itself (source of truth; never published)
|
|
160
|
+
│ ├── SKILL.md
|
|
161
|
+
│ ├── references/ # 11 playbooks (incl. licensing.md)
|
|
162
|
+
│ └── templates/ # 5 fill-in templates (incl. 3D scene brief)
|
|
163
|
+
├── docs/ # ← the only content tracked in Git
|
|
164
|
+
│ ├── INSTALL.md # install guide for all 15 agents
|
|
165
|
+
│ ├── EXAMPLES.md # worked walkthroughs: Mode A + Mode B
|
|
166
|
+
│ └── LICENSING.md # Pro plan, payment steps, key/admin credentials
|
|
167
|
+
└── README.md # ← tracked in Git
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
> **Git vs npm vs skill source — nothing public carries your source:**
|
|
171
|
+
> - **Git:** only `README.md` and `docs/` are visible (`.gitignore` hides the rest).
|
|
172
|
+
> - **npm:** only the installer + docs are published (npm tarballs are public forever, so `skill/` is excluded) — set `awd.source` in `package.json` before publishing.
|
|
173
|
+
> - **Skill source:** `skill/` is fetched by the installer from the URL/path you configure (`--source`, `AWD_SOURCE`, or `awd.source`), with `--token`/`AWD_TOKEN` for private hosts.
|
|
174
|
+
|
|
175
|
+
## Development
|
|
176
|
+
|
|
177
|
+
Edit files under `skill/`, then refresh your local opencode install:
|
|
178
|
+
|
|
179
|
+
```bash
|
|
180
|
+
node bin/install.js install --agent=opencode --force
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
Check the package contents before publishing:
|
|
184
|
+
|
|
185
|
+
```bash
|
|
186
|
+
npm run pack:check
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
## Publishing to npm
|
|
190
|
+
|
|
191
|
+
```bash
|
|
192
|
+
# 1. point the installer at your private skill source first (never published to npm)
|
|
193
|
+
# edit package.json -> "awd": { "source": "https://api.github.com/repos/YOU/REPO/tarball/main" }
|
|
194
|
+
# (end users pass the token: AWD_TOKEN=... npx agentic-web-developer install)
|
|
195
|
+
|
|
196
|
+
npm login # once, with your npm account
|
|
197
|
+
npm publish # publishes bin + docs only (publishConfig.access = "public")
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
Bump `version` in `package.json` for every update, then `npm publish` again.
|
|
201
|
+
|
|
202
|
+
## License
|
|
203
|
+
|
|
204
|
+
UNLICENSED — all rights reserved by the author. Replace the `license` field in `package.json` and add a LICENSE file if you intend to distribute it under a specific license.
|
package/docs/INSTALL.md
CHANGED
|
@@ -1,147 +1,149 @@
|
|
|
1
|
-
# Installing agentic-web-developer
|
|
2
|
-
|
|
3
|
-
The skill installs into **15 AI coding agents** — the same 15 the AnimotionJS skill supports. The installer writes each agent's own file format (`SKILL.md`, `skill.md`, a rules file, or `CONVENTIONS.md`) with the right frontmatter, plus the reference playbooks and templates alongside it.
|
|
4
|
-
|
|
5
|
-
> **The npm package contains only the installer and these docs** — never the skill source. The installer fetches the skill payload from a *skill source* you configure (see [Skill source](#skill-source)).
|
|
6
|
-
|
|
7
|
-
## Quick start
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
# auto-detect your agent (opencode -> claude -> any detected agent)
|
|
11
|
-
npx agentic-web-developer install
|
|
12
|
-
|
|
13
|
-
# target one agent by key
|
|
14
|
-
npx agentic-web-developer install --agent=claude
|
|
15
|
-
|
|
16
|
-
# install for every supported agent at once
|
|
17
|
-
npx agentic-web-developer install --all
|
|
18
|
-
|
|
19
|
-
# see what's installed, and where
|
|
20
|
-
npx agentic-web-developer detect
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
Then **restart your AI agent** so it loads the skill.
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
|
30
|
-
|
|
31
|
-
| `--
|
|
32
|
-
| `--
|
|
33
|
-
| `--
|
|
34
|
-
| `--
|
|
35
|
-
| `--
|
|
36
|
-
| `--
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
**
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
|
74
|
-
|
|
75
|
-
| `
|
|
76
|
-
| `
|
|
77
|
-
| `
|
|
78
|
-
| `
|
|
79
|
-
| `
|
|
80
|
-
| `
|
|
81
|
-
| `
|
|
82
|
-
| `
|
|
83
|
-
| `
|
|
84
|
-
| `
|
|
85
|
-
| `
|
|
86
|
-
| `
|
|
87
|
-
| `
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
- **
|
|
102
|
-
- **
|
|
103
|
-
- **
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
npx animotion-skills install --
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
- **
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
1
|
+
# Installing agentic-web-developer
|
|
2
|
+
|
|
3
|
+
The skill installs into **15 AI coding agents** — the same 15 the AnimotionJS skill supports. The installer writes each agent's own file format (`SKILL.md`, `skill.md`, a rules file, or `CONVENTIONS.md`) with the right frontmatter, plus the reference playbooks and templates alongside it.
|
|
4
|
+
|
|
5
|
+
> **The npm package contains only the installer and these docs** — never the skill source. The installer fetches the skill payload from a *skill source* you configure (see [Skill source](#skill-source)).
|
|
6
|
+
|
|
7
|
+
## Quick start
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
# auto-detect your agent (opencode -> claude -> any detected agent)
|
|
11
|
+
npx agentic-web-developer install
|
|
12
|
+
|
|
13
|
+
# target one agent by key
|
|
14
|
+
npx agentic-web-developer install --agent=claude
|
|
15
|
+
|
|
16
|
+
# install for every supported agent at once
|
|
17
|
+
npx agentic-web-developer install --all
|
|
18
|
+
|
|
19
|
+
# see what's installed, and where
|
|
20
|
+
npx agentic-web-developer detect
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Then **restart your AI agent** so it loads the skill.
|
|
24
|
+
|
|
25
|
+
> **License:** the skill is gated by the Animotion **Pro plan ($7/month)** — on first run it validates your key (or admin credentials) once per session before any work. Paying, downloading the files directly with a key, and wiring credentials up: **[LICENSING.md](LICENSING.md)**.
|
|
26
|
+
|
|
27
|
+
### All flags
|
|
28
|
+
|
|
29
|
+
| Flag | Effect |
|
|
30
|
+
|---|---|
|
|
31
|
+
| `--agent=<key>` | Install for one agent (keys in the table below) |
|
|
32
|
+
| `--agent=all` / `--all` | Install for all 15 agents |
|
|
33
|
+
| `--source=<url\|path>` | Skill source: a `.tar.gz`/`.zip` URL, or a local skill folder/archive |
|
|
34
|
+
| `--token=<key>` | Auth token for a private source (else `AWD_TOKEN`) |
|
|
35
|
+
| `--force` | Overwrite an existing install |
|
|
36
|
+
| `--dry-run` | Print the target paths without writing anything |
|
|
37
|
+
| `--dir=<path>` | Install flat into `<path>/agentic-web-developer/` (SKILL.md layout) |
|
|
38
|
+
| `--home=<path>` | Use `<path>` as the home directory (for testing) |
|
|
39
|
+
|
|
40
|
+
## Skill source
|
|
41
|
+
|
|
42
|
+
Because the npm tarball ships no `skill/` folder, the installer resolves the payload from the first available source, in this order:
|
|
43
|
+
|
|
44
|
+
1. `--source=<url|path>` — explicit flag
|
|
45
|
+
2. `AWD_SOURCE=<url|path>` — environment variable
|
|
46
|
+
3. `skill/` next to `bin/` — local development checkout (used automatically)
|
|
47
|
+
4. `awd.source` in `package.json` — set by the package author before publishing
|
|
48
|
+
|
|
49
|
+
**URL sources** are downloaded and extracted (system `tar`; `.tar.gz` preferred, `.zip` works on Windows/macOS). The archive may be the repo root, a `skill/` folder inside it, or anything containing `SKILL.md` within three levels.
|
|
50
|
+
|
|
51
|
+
**Private sources** need a token: `--token=<key>` or `AWD_TOKEN=<key>` (`GITHUB_TOKEN` is used automatically for github.com URLs):
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
# private GitHub repo (tarball API)
|
|
55
|
+
npx agentic-web-developer install --source=https://api.github.com/repos/YOU/private-skill/tarball/main --token=ghp_XXXX
|
|
56
|
+
|
|
57
|
+
# same, via environment (handy for CI or shell profiles)
|
|
58
|
+
export AWD_SOURCE=https://api.github.com/repos/YOU/private-skill/tarball/main
|
|
59
|
+
export AWD_TOKEN=ghp_XXXX
|
|
60
|
+
npx agentic-web-developer install
|
|
61
|
+
|
|
62
|
+
# your own server / object storage
|
|
63
|
+
npx agentic-web-developer install --source=https://your-server/skill.tar.gz
|
|
64
|
+
|
|
65
|
+
# local folder or archive (no network)
|
|
66
|
+
npx agentic-web-developer install --source=~/backups/skill
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
The package author normally sets `awd.source` in `package.json` once, so end users just run `npx agentic-web-developer install` with no configuration.
|
|
70
|
+
|
|
71
|
+
## Where each agent gets the skill
|
|
72
|
+
|
|
73
|
+
| Key | Agent | File written | Plus |
|
|
74
|
+
|---|---|---|---|
|
|
75
|
+
| `opencode` | OpenCode | `~/.config/opencode/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
|
|
76
|
+
| `claude` | Claude Code | `~/.claude/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
|
|
77
|
+
| `copilot` | GitHub Copilot | `%APPDATA%\github-copilot\skills\agentic-web-developer\SKILL.md` | `references/`, `templates/` |
|
|
78
|
+
| `cursor` | Cursor | `~/.cursor/rules/agentic-web-developer.mdc` | payload in `~/.cursor/skills/agentic-web-developer/` |
|
|
79
|
+
| `windsurf` | Windsurf (Codeium) | `~/.codeium/windsurf/skills/agentic-web-developer/skill.md` | `references/`, `templates/` |
|
|
80
|
+
| `cody` | Cody (Sourcegraph) | `~/.cody/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
|
|
81
|
+
| `codium` | Codium | `~/.codium/skills/agentic-web-developer/skill.md` | `references/`, `templates/` |
|
|
82
|
+
| `aider` | Aider | `~/.aider/skills/CONVENTIONS.md` | payload in `~/.aider/skills/agentic-web-developer/` |
|
|
83
|
+
| `continue` | Continue | `~/.continue/rules/agentic-web-developer.md` | payload in `~/.continue/skills/agentic-web-developer/` |
|
|
84
|
+
| `codex` | Codex (OpenAI) | `~/.codex/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
|
|
85
|
+
| `roo` | Roo Code | `~/.roo/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
|
|
86
|
+
| `cline` | Cline | `~/.cline/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
|
|
87
|
+
| `augment` | Augment | `~/.augment/rules/agentic-web-developer.md` | payload in `~/.augment/skills/agentic-web-developer/` |
|
|
88
|
+
| `amazonq` | Amazon Q | `~/.amazonq/rules/agentic-web-developer.md` | payload in `~/.amazonq/skills/agentic-web-developer/` |
|
|
89
|
+
| `jetbrains` | JetBrains AI | `~/.junie/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
|
|
90
|
+
|
|
91
|
+
Notes:
|
|
92
|
+
|
|
93
|
+
- **Rules agents** (cursor, continue, augment, amazonq) receive the full skill body as a rules file with agent-specific frontmatter (`globs`, `alwaysApply`, `trigger`, …). The file starts with a pointer to the installed `references/` and `templates/` payload so the agent can read the playbooks on demand.
|
|
94
|
+
- **Aider** has no skill loader — it reads conventions files. The skill lands at `~/.aider/skills/CONVENTIONS.md`. Point Aider at it with `aider --read ~/.aider/skills/CONVENTIONS.md`, or copy that file into a project as `CONVENTIONS.md`. The installer never overwrites a `CONVENTIONS.md` it didn't write (unless you pass `--force`), so an existing Animotion or other conventions file is safe.
|
|
95
|
+
- Windows paths are shown with `~` for your user home; `%APPDATA%` is your Roaming app-data folder.
|
|
96
|
+
|
|
97
|
+
## Manual install (no CLI)
|
|
98
|
+
|
|
99
|
+
Get the skill folder itself (the package doesn't contain it — take it from your configured source, or a copy someone sent you), then place the files as the table above says:
|
|
100
|
+
|
|
101
|
+
- **SKILL.md agents** — copy the `skill/` folder to `<skills-dir>/agentic-web-developer/` (it must contain `SKILL.md`, `references/`, `templates/`).
|
|
102
|
+
- **Windsurf / Codium** — same, but rename `SKILL.md` to `skill.md`.
|
|
103
|
+
- **Cursor** — copy `skill/SKILL.md` to `~/.cursor/rules/agentic-web-developer.mdc`, keep `references/` + `templates/` in `~/.cursor/skills/agentic-web-developer/`.
|
|
104
|
+
- **Continue / Augment / Amazon Q** — copy `skill/SKILL.md` to the agent's `rules/agentic-web-developer.md` (paths in the table), payload alongside in `skills/agentic-web-developer/`.
|
|
105
|
+
- **Aider** — copy `skill/SKILL.md` (without its `---` frontmatter block) to `~/.aider/skills/CONVENTIONS.md`.
|
|
106
|
+
|
|
107
|
+
## Verify
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
npx agentic-web-developer detect
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
`INSTALLED` next to an agent means the skill file and its payload are both in place.
|
|
114
|
+
|
|
115
|
+
## Uninstall
|
|
116
|
+
|
|
117
|
+
Delete what the table lists for your agent — the skill file **and** the `agentic-web-developer/` payload folder. For example:
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
# opencode
|
|
121
|
+
rm -rf ~/.config/opencode/skills/agentic-web-developer
|
|
122
|
+
|
|
123
|
+
# cursor (rule file + payload)
|
|
124
|
+
rm -f ~/.cursor/rules/agentic-web-developer.mdc
|
|
125
|
+
rm -rf ~/.cursor/skills/agentic-web-developer
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Companion: AnimotionJS (required for animation)
|
|
129
|
+
|
|
130
|
+
Every site built with this skill gets its **animations from the AnimotionJS agentic skill** — this skill never writes motion code. Install Animotion for the same agent:
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
npx animotion-skills install --tier=agentic --agent=<agent> --license-key=YOUR_KEY
|
|
134
|
+
npx animotion-skills install --tier=agentic --all --license-key=YOUR_KEY # every detected agent
|
|
135
|
+
npx animotion-skills install --detect
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
- License key (Studio plan, $15/month): https://skills.animotion.click/checkout
|
|
139
|
+
- Without a key the build still works up to Stage 8 (animation handoff), where it stops and asks you to install Animotion.
|
|
140
|
+
|
|
141
|
+
## Repository vs npm package vs skill source
|
|
142
|
+
|
|
143
|
+
- **This Git repository** contains **documentation only** (`README.md`, `docs/`) — the `.gitignore` hides everything else.
|
|
144
|
+
- **The npm package** contains **only the installer** (`bin/install.js`) + docs — never `skill/`. Anything in a published tarball is publicly downloadable forever, so the source stays out of it.
|
|
145
|
+
- **The skill source** lives wherever you say: [Skill source](#skill-source) (`--source`, `AWD_SOURCE`, or the author's `awd.source`).
|
|
146
|
+
|
|
147
|
+
## Examples
|
|
148
|
+
|
|
149
|
+
Two full scenario walkthroughs — one per mode — are in [EXAMPLES.md](./EXAMPLES.md).
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
# Licensing — paying for Pro and unlocking the skill
|
|
2
|
+
|
|
3
|
+
The agentic-web-developer skill is licensed: it needs an active **Pro plan ($7/month)** Animotion key, or Animotion **admin credentials**, verified **once per session** (cached 7 days) before any pipeline work. This guide covers paying for Pro, installing the skill files with a key or admin credentials, and wiring the credentials up.
|
|
4
|
+
|
|
5
|
+
## How to pay for Pro
|
|
6
|
+
|
|
7
|
+
[](https://skills.animotion.click/checkout?plan=pro) [](https://skills.animotion.click/checkout?plan=studio)
|
|
8
|
+
|
|
9
|
+
1. **Click a Get Pro button** — opens [`skills.animotion.click/checkout?plan=pro`](https://skills.animotion.click/checkout?plan=pro) with the **Pro** plan preselected ($7/month). Studio ($15/month) also unlocks this skill *and* the AnimotionJS agentic animation skill the pipeline hands off to at Stage 8 — usually the better deal if you'll ship sites.
|
|
10
|
+
2. **Enter your email** — the license key is tied to this address.
|
|
11
|
+
3. **Continue to Payment** — you are redirected to Stripe's hosted checkout (card payment; Stripe handles everything).
|
|
12
|
+
4. **Confirm the subscription** — $7/month, renews monthly, cancel anytime from the Stripe invoice email.
|
|
13
|
+
5. **Copy your license key** — the confirmation page shows it immediately (`sec_live_…`).
|
|
14
|
+
|
|
15
|
+
> **Admin credentials are not self-serve.** `--admin-email`/`--admin-secret` and `AGENTIC_ADMIN_*` are a staff bypass for whitelisted emails — everyone else pays with a Pro key from the flow above.
|
|
16
|
+
|
|
17
|
+
## Install the skill files (license key or admin credentials)
|
|
18
|
+
|
|
19
|
+
The npm package ships only the installer — the skill files can also be downloaded directly from the license server with your key or admin pair (Node 18+; opencode path shown):
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
# bash / zsh — with a Pro license key
|
|
23
|
+
KEY="sec_live_xxxxxxxx" \
|
|
24
|
+
DEST="$HOME/.config/opencode/skills/agentic-web-developer" \
|
|
25
|
+
node -e '
|
|
26
|
+
const fs = require("fs"), path = require("path");
|
|
27
|
+
(async () => {
|
|
28
|
+
const url = "https://skills.animotion.click/api/skills?skill=agentic-web-developer&licenseKey=" + process.env.KEY;
|
|
29
|
+
const j = await (await fetch(url)).json();
|
|
30
|
+
if (!j.success) throw new Error("Download failed - check the key");
|
|
31
|
+
for (const f of j.skills) {
|
|
32
|
+
const p = path.join(process.env.DEST, f.name);
|
|
33
|
+
fs.mkdirSync(path.dirname(p), { recursive: true });
|
|
34
|
+
fs.writeFileSync(p, f.content);
|
|
35
|
+
}
|
|
36
|
+
console.log("Installed " + j.count + " files -> " + process.env.DEST);
|
|
37
|
+
})();
|
|
38
|
+
'
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
```powershell
|
|
42
|
+
# PowerShell — with a Pro license key
|
|
43
|
+
$env:KEY = "sec_live_xxxxxxxx"
|
|
44
|
+
$env:DEST = "$env:USERPROFILE\.config\opencode\skills\agentic-web-developer"
|
|
45
|
+
node -e 'const fs=require("fs"),path=require("path");(async()=>{const j=await (await fetch("https://skills.animotion.click/api/skills?skill=agentic-web-developer&licenseKey="+process.env.KEY)).json();if(!j.success)throw new Error("Download failed - check the key");for(const f of j.skills){const p=path.join(process.env.DEST,f.name);fs.mkdirSync(path.dirname(p),{recursive:true});fs.writeFileSync(p,f.content);}console.log("Installed "+j.count+" files -> "+process.env.DEST);})()'
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
**With admin credentials instead of a key** (whitelisted emails only) — same scripts, swap the URL query string for:
|
|
49
|
+
|
|
50
|
+
```
|
|
51
|
+
.../api/skills?skill=agentic-web-developer&adminEmail=you@example.com&adminSecret=YOUR_ADMIN_SECRET
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Other agents: change `DEST` (e.g. `~/.config/claude/skills/…` for Claude Code, `~/.config/github-copilot/skills/…` for Copilot — full per-agent paths in [INSTALL.md](INSTALL.md)). Restart the agent afterwards so the skill loads. The [`npx agentic-web-developer install`](INSTALL.md) CLI works the same way once a key/admin pair is available.
|
|
55
|
+
|
|
56
|
+
## Add your license key or admin credentials
|
|
57
|
+
|
|
58
|
+
Pick one — the skill's gate looks for environment variables first, then the installer's config file, then asks you once.
|
|
59
|
+
|
|
60
|
+
**1. Install the AnimotionJS skill with your key (recommended — one command, everything wired)**
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx animotion-skills install --tier=agentic --agent=<your-agent> --license-key=YOUR_KEY
|
|
64
|
+
|
|
65
|
+
# or install for every detected agent at once:
|
|
66
|
+
npx animotion-skills install --tier=agentic --all --license-key=YOUR_KEY
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
With **admin credentials instead of a license key** (Animotion staff / whitelisted emails only):
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
npx animotion-skills install --tier=agentic --agent=<your-agent> --admin-email=you@example.com --admin-secret=YOUR_ADMIN_SECRET
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
`<your-agent>` is one of the 15 supported agents (`opencode`, `claude`, `copilot`, `cursor`, … — full list in [INSTALL.md](INSTALL.md)). This installs the AnimotionJS animation skill (you need it at Stage 8 anyway) **and** writes `animotion-config.json` next to it — the agentic-web-developer gate reads that file automatically, so nothing else to configure.
|
|
76
|
+
|
|
77
|
+
> Note: this installer's `agentic` tier requires the **Studio plan** ($15/month). On the **Pro plan** only ($7/month), use options 2–4 instead — the gate itself accepts any active Pro key.
|
|
78
|
+
|
|
79
|
+
**2. Environment variable**
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
# bash / zsh — add to ~/.bashrc or ~/.zshrc
|
|
83
|
+
export AGENTIC_LICENSE_KEY="sec_live_xxxxxxxx"
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
```powershell
|
|
87
|
+
# PowerShell — persistent for your user (open a new terminal afterwards)
|
|
88
|
+
setx AGENTIC_LICENSE_KEY "sec_live_xxxxxxxx"
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
`ANIMOTION_LICENSE_KEY` works as an alias — one variable can serve this skill and the Animotion installer.
|
|
92
|
+
|
|
93
|
+
**3. `animotion-config.json` by hand** — same file the installer writes. The gate reads it from the agentic-web-developer skill directory, its parent (`~/.config/opencode/skills/` for opencode), `~/.animotion-skills/`, or the path in `AGENTIC_LICENSE_CONFIG`:
|
|
94
|
+
|
|
95
|
+
```json
|
|
96
|
+
{
|
|
97
|
+
"tier": "pro",
|
|
98
|
+
"requiredPlan": "pro",
|
|
99
|
+
"authMethod": "license",
|
|
100
|
+
"licenseKey": "sec_live_xxxxxxxx"
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
**4. Admin credentials via environment** (Animotion staff / whitelisted emails only) — env vars `AGENTIC_ADMIN_EMAIL` + `AGENTIC_ADMIN_SECRET`, or a config file with `"authMethod": "admin"` and `adminEmail` / `adminSecret` fields (installer-written files store the secret encrypted as `adminSecretEncrypted` + `encryptionKey`; the gate decrypts those automatically). Never commit these — prefer a personal Pro key for day-to-day work.
|
|
105
|
+
|
|
106
|
+
**5. Ask in-session**
|
|
107
|
+
|
|
108
|
+
With nothing found, the skill asks once (via its question tool) — paste the key, it validates immediately and remembers it via the cache below.
|
|
109
|
+
|
|
110
|
+
## What happens at runtime
|
|
111
|
+
|
|
112
|
+
- Once per session (at most), the skill calls:
|
|
113
|
+
`POST https://skills.animotion.click/api/license/validate`
|
|
114
|
+
with `{ "licenseKey": "…", "skill": "agentic-web-developer", "plan": "pro" }` (or the admin-credential variant).
|
|
115
|
+
- On success the verdict is cached at `~/.animotion-skills/cache/agentic-web-developer-verdict.json` for **7 days** — later sessions in that window skip the network call.
|
|
116
|
+
- The server answers `valid: true` for Pro and Studio keys and for whitelisted admins; `valid: false` carries a `reason` (invalid key, wrong plan, not whitelisted).
|
|
117
|
+
- If the server is unreachable, a fresh cache (≤7 days) still lets you work; without one, the skill stops until it can verify once.
|
|
118
|
+
|
|
119
|
+
Point the gate at a local dev server with `AGENTIC_LICENSE_SERVER=http://localhost:5000` (defaults to `https://skills.animotion.click`).
|
|
120
|
+
|
|
121
|
+
## Troubleshooting
|
|
122
|
+
|
|
123
|
+
| Symptom | Fix |
|
|
124
|
+
|---|---|
|
|
125
|
+
| `valid: false`, reason "Invalid license format" / "Invalid signature" | Wrong or truncated key — copy it again from the checkout confirmation page. |
|
|
126
|
+
| `valid: false`, reason mentions the plan | Your key's plan is below Pro — [upgrade at checkout](https://skills.animotion.click/checkout?plan=pro). |
|
|
127
|
+
| `valid: false`, reason "Email not whitelisted" | Admin path but the email isn't on the server whitelist — use a Pro key instead. |
|
|
128
|
+
| `valid: false`, reason "Invalid admin secret" | `AGENTIC_ADMIN_SECRET` doesn't match the server's `ADMIN_SECRET`. |
|
|
129
|
+
| Skill keeps asking for the key | Verdict cache expired or unwritable — fix credentials, then run one validation; check `~/.animotion-skills/cache/` is writable. |
|
|
130
|
+
| "server unreachable, no cached verdict" | No network on first use — connect once; after that the 7-day cache covers offline work. |
|
|
131
|
+
| Changed or cancelled the subscription | Delete `~/.animotion-skills/cache/agentic-web-developer-verdict.json` to force a re-check immediately. |
|
|
132
|
+
| Download of the skill files returns 401/403 | The install commands above need a valid key/admin pair on the query string — re-check step 5 of "How to pay for Pro". |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentic-web-developer",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "Agentic skill for building high-converting websites that sell — design DNA extraction, outlier competitor research, conversion blueprints, the M.O.N.E.Y sales framework, lead generation, cloning, outreach and deployment, with a novel-idea/product-launch mode. All animation work is delegated to the AnimotionJS agentic skill.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"opencode",
|
|
@@ -35,7 +35,7 @@
|
|
|
35
35
|
},
|
|
36
36
|
"license": "UNLICENSED",
|
|
37
37
|
"awd": {
|
|
38
|
-
"source": "https://4e2zaktqel.ucarecd.net/
|
|
38
|
+
"source": "https://4e2zaktqel.ucarecd.net/8bbedf86-8578-49c4-9477-0a5a685094af/skilltar.gz"
|
|
39
39
|
},
|
|
40
40
|
"publishConfig": {
|
|
41
41
|
"access": "public"
|