fluentcart-developer 1.1.0 → 1.1.1
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/CLAUDE.md +22 -22
- package/LICENSE +21 -21
- package/README.md +169 -127
- package/SKILL.md +127 -127
- package/bin/index.js +281 -281
- package/package.json +48 -37
- package/skills/fluentcart-developer/SKILL.md +172 -172
- package/skills/fluentcart-developer/examples/README.md +25 -25
- package/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/fluent-cart/checkout.php +32 -32
- package/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/functions.php +40 -40
- package/skills/fluentcart-developer/examples/sample-custom-addon/fluentcart-custom-addon.php +114 -114
- package/skills/fluentcart-developer/examples/sample-custom-payment-gateway/fluentcart-custom-gateway-example.php +149 -149
- package/skills/fluentcart-developer/examples/sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php +38 -38
- package/skills/fluentcart-developer/examples/sample-shipping-carrier/fluentcart-custom-shipping-carrier.php +62 -62
- package/skills/fluentcart-developer/references/action-hooks-admin-templates.md +787 -787
- package/skills/fluentcart-developer/references/action-hooks-cart-checkout.md +1355 -1355
- package/skills/fluentcart-developer/references/action-hooks-customers-users.md +266 -266
- package/skills/fluentcart-developer/references/action-hooks-licenses.md +855 -855
- package/skills/fluentcart-developer/references/action-hooks-orders.md +631 -631
- package/skills/fluentcart-developer/references/action-hooks-payments-integrations.md +963 -963
- package/skills/fluentcart-developer/references/action-hooks-products-coupons.md +585 -585
- package/skills/fluentcart-developer/references/action-hooks-subscriptions.md +661 -661
- package/skills/fluentcart-developer/references/database-models-query-builder.md +194 -194
- package/skills/fluentcart-developer/references/database-models-reference.md +604 -604
- package/skills/fluentcart-developer/references/database-schema-reference.md +940 -940
- package/skills/fluentcart-developer/references/engineering-notes.md +154 -154
- package/skills/fluentcart-developer/references/fee-system-guide.md +449 -449
- package/skills/fluentcart-developer/references/filter-hooks-cart-checkout.md +1202 -1202
- package/skills/fluentcart-developer/references/filter-hooks-customers-subscriptions.md +902 -902
- package/skills/fluentcart-developer/references/filter-hooks-integrations-advanced.md +1598 -1598
- package/skills/fluentcart-developer/references/filter-hooks-orders-payments.md +1319 -1319
- package/skills/fluentcart-developer/references/filter-hooks-products-pricing.md +628 -628
- package/skills/fluentcart-developer/references/filter-hooks-settings-configuration.md +1177 -1177
- package/skills/fluentcart-developer/references/fluentcart-developer-guide.md +154 -154
- package/skills/fluentcart-developer/references/ghost-product-selling.md +458 -458
- package/skills/fluentcart-developer/references/modules-and-extensions-reference.md +224 -224
- package/skills/fluentcart-developer/references/payment-gateway-integration.md +761 -761
- package/skills/fluentcart-developer/references/rest-api-checkout.md +286 -286
- package/skills/fluentcart-developer/references/rest-api-coupons.md +794 -794
- package/skills/fluentcart-developer/references/rest-api-customer-profile.md +190 -190
- package/skills/fluentcart-developer/references/rest-api-customers.md +1121 -1121
- package/skills/fluentcart-developer/references/rest-api-dashboard-utilities.md +219 -219
- package/skills/fluentcart-developer/references/rest-api-email-notifications.md +619 -619
- package/skills/fluentcart-developer/references/rest-api-files.md +290 -290
- package/skills/fluentcart-developer/references/rest-api-integrations.md +324 -324
- package/skills/fluentcart-developer/references/rest-api-labels-attributes.md +321 -321
- package/skills/fluentcart-developer/references/rest-api-licensing.md +171 -171
- package/skills/fluentcart-developer/references/rest-api-order-bumps.md +200 -200
- package/skills/fluentcart-developer/references/rest-api-orders.md +1241 -1241
- package/skills/fluentcart-developer/references/rest-api-overview.md +131 -131
- package/skills/fluentcart-developer/references/rest-api-products.md +2563 -2563
- package/skills/fluentcart-developer/references/rest-api-public-shop.md +172 -172
- package/skills/fluentcart-developer/references/rest-api-reference.md +552 -552
- package/skills/fluentcart-developer/references/rest-api-reports.md +377 -377
- package/skills/fluentcart-developer/references/rest-api-roles-permissions.md +147 -147
- package/skills/fluentcart-developer/references/rest-api-settings.md +528 -528
- package/skills/fluentcart-developer/references/rest-api-shipping.md +799 -799
- package/skills/fluentcart-developer/references/rest-api-subscriptions.md +606 -606
- package/skills/fluentcart-developer/references/rest-api-tax.md +356 -356
- package/skills/fluentcart-developer/references/subscription-customization.md +197 -197
- package/skills/fluentcart-developer/scripts/cli.js +1 -1
- package/.gitattributes +0 -2
- package/CONTRIBUTING.md +0 -73
- package/copy-skills.js +0 -43
- package/skills.sh.json +0 -13
package/CLAUDE.md
CHANGED
|
@@ -1,22 +1,22 @@
|
|
|
1
|
-
Skills are organized into bucket folders under `skills/`:
|
|
2
|
-
|
|
3
|
-
- `engineering/` — daily code work
|
|
4
|
-
- `productivity/` — daily non-code workflow tools
|
|
5
|
-
- `misc/` — kept around but rarely used, not promoted
|
|
6
|
-
- `personal/` — tied to my own setup, not promoted
|
|
7
|
-
- `in-progress/` — drafts not yet ready to ship
|
|
8
|
-
- `deprecated/` — no longer used
|
|
9
|
-
|
|
10
|
-
Every skill in `engineering/` or `productivity/` (the **promoted** buckets) must have a reference in the top-level `README.md` and an entry in `.claude-plugin/plugin.json`. Skills in `misc/`, `personal/`, `in-progress/`, and `deprecated/` must not appear in either.
|
|
11
|
-
|
|
12
|
-
Each skill entry in the top-level `README.md` must link the skill name to its `SKILL.md`.
|
|
13
|
-
|
|
14
|
-
Each bucket folder has a `README.md` that lists every skill in the bucket with a one-line description, with the skill name linked to its `SKILL.md`. The promoted buckets' `README.md`s and the top-level `README.md` group entries into **User-invoked** and **Model-invoked**; non-promoted bucket `README.md`s (`misc/`, `personal/`) use a flat list.
|
|
15
|
-
|
|
16
|
-
Skills in `engineering/` and `productivity/` also have a human-facing docs page at `docs/<bucket>/<skill-name>.md` (the docs tree mirrors those two bucket folders under `skills/`). The published URL is `https://aihero.dev/skills-<skill-name>` regardless of bucket — the docs path is repo organisation only. When you add, rename, or change the behaviour of a skill in `engineering/` or `productivity/`, create or re-sync its docs page following [.agents/writing-docs.md](./.agents/writing-docs.md). Skills in the non-promoted buckets (`misc/`, `personal/`, `in-progress/`, `deprecated/`) get **no** docs page.
|
|
17
|
-
|
|
18
|
-
Every `SKILL.md` is either user-invoked (`disable-model-invocation: true`, reachable only by the human) or model-invoked (model- or user-reachable). See [.agents/invocation.md](./.agents/invocation.md).
|
|
19
|
-
|
|
20
|
-
[`ask-matt`](./skills/engineering/ask-matt/SKILL.md) is the router that maps every user-reachable skill and how they relate. The same trigger that re-syncs a docs page applies to it: whenever you add, rename, remove, or change how a user-reachable skill fits the flows, re-read `ask-matt`'s `SKILL.md` and update it so the map stays accurate — a new skill it never mentions, or a stale one it still routes to, is a router that lies.
|
|
21
|
-
|
|
22
|
-
To (re)link every skill into the local harness skill directories (`~/.claude/skills`, `~/.agents/skills`), run `scripts/link-skills.sh`. Each entry is a symlink into this repo, so a `git pull` keeps installed skills current; re-run the script after adding, removing, or renaming a skill.
|
|
1
|
+
Skills are organized into bucket folders under `skills/`:
|
|
2
|
+
|
|
3
|
+
- `engineering/` — daily code work
|
|
4
|
+
- `productivity/` — daily non-code workflow tools
|
|
5
|
+
- `misc/` — kept around but rarely used, not promoted
|
|
6
|
+
- `personal/` — tied to my own setup, not promoted
|
|
7
|
+
- `in-progress/` — drafts not yet ready to ship
|
|
8
|
+
- `deprecated/` — no longer used
|
|
9
|
+
|
|
10
|
+
Every skill in `engineering/` or `productivity/` (the **promoted** buckets) must have a reference in the top-level `README.md` and an entry in `.claude-plugin/plugin.json`. Skills in `misc/`, `personal/`, `in-progress/`, and `deprecated/` must not appear in either.
|
|
11
|
+
|
|
12
|
+
Each skill entry in the top-level `README.md` must link the skill name to its `SKILL.md`.
|
|
13
|
+
|
|
14
|
+
Each bucket folder has a `README.md` that lists every skill in the bucket with a one-line description, with the skill name linked to its `SKILL.md`. The promoted buckets' `README.md`s and the top-level `README.md` group entries into **User-invoked** and **Model-invoked**; non-promoted bucket `README.md`s (`misc/`, `personal/`) use a flat list.
|
|
15
|
+
|
|
16
|
+
Skills in `engineering/` and `productivity/` also have a human-facing docs page at `docs/<bucket>/<skill-name>.md` (the docs tree mirrors those two bucket folders under `skills/`). The published URL is `https://aihero.dev/skills-<skill-name>` regardless of bucket — the docs path is repo organisation only. When you add, rename, or change the behaviour of a skill in `engineering/` or `productivity/`, create or re-sync its docs page following [.agents/writing-docs.md](./.agents/writing-docs.md). Skills in the non-promoted buckets (`misc/`, `personal/`, `in-progress/`, `deprecated/`) get **no** docs page.
|
|
17
|
+
|
|
18
|
+
Every `SKILL.md` is either user-invoked (`disable-model-invocation: true`, reachable only by the human) or model-invoked (model- or user-reachable). See [.agents/invocation.md](./.agents/invocation.md).
|
|
19
|
+
|
|
20
|
+
[`ask-matt`](./skills/engineering/ask-matt/SKILL.md) is the router that maps every user-reachable skill and how they relate. The same trigger that re-syncs a docs page applies to it: whenever you add, rename, remove, or change how a user-reachable skill fits the flows, re-read `ask-matt`'s `SKILL.md` and update it so the map stays accurate — a new skill it never mentions, or a stale one it still routes to, is a router that lies.
|
|
21
|
+
|
|
22
|
+
To (re)link every skill into the local harness skill directories (`~/.claude/skills`, `~/.agents/skills`), run `scripts/link-skills.sh`. Each entry is a symlink into this repo, so a `git pull` keeps installed skills current; re-run the script after adding, removing, or renaming a skill.
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 Matt Pocock
|
|
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
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Matt Pocock
|
|
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.
|
package/README.md
CHANGED
|
@@ -1,127 +1,169 @@
|
|
|
1
|
-
# Atif Jubaer's Agent Skills Repository
|
|
2
|
-
|
|
3
|
-
[](https://www.npmjs.com/package/fluentcart-developer)
|
|
4
|
-
[](https://opensource.org/licenses/MIT)
|
|
5
|
-
|
|
6
|
-
A comprehensive, platform-agnostic knowledge base, instruction set, and CLI toolkit for FluentCart theme, plugin, shipping, and payment gateway development.
|
|
7
|
-
|
|
8
|
-
This repository provides ready-to-use configurations, reference manuals, and code boilerplates for all major AI coding assistants (Antigravity, Cursor, Claude Code, Windsurf, Cline, Zed, GitHub Copilot), enabling them to write correct, compatible code for FluentCart out-of-the-box.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Included Skills
|
|
13
|
-
|
|
14
|
-
- **`FluentCart Developer`** (`fluentcart-developer`):
|
|
15
|
-
- **Complete Database Manual:** 34 DB migrations, all `wp_fct_*` schema tables, Eloquent ORM models, relationships, and Query Builder.
|
|
16
|
-
- **315+ Action & Filter Hooks:** 14 dedicated hook reference files covering order lifecycles, payment webhooks, cart fees, and admin UI.
|
|
17
|
-
- **15 REST API Modules (Core & Pro):** Orders, Products, Customers, Coupons, Subscriptions, Tax, Shipping, Settings, Email Notifications, Reports, Integrations, Files, Labels & Attributes, Dashboard & Utilities, Public Shop, Checkout, Customer Profile, Software Licensing (Pro), Roles & Permissions (Pro), Order Bumps (Pro).
|
|
18
|
-
- **5 Runnable Example Projects:** Custom Addon plugin, Fee Surcharge plugin, Payment Gateway plugin, Shipping Carrier, and Starter Child Theme.
|
|
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
|
-
|
|
1
|
+
# Atif Jubaer's Agent Skills Repository
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/fluentcart-developer)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
5
|
+
|
|
6
|
+
A comprehensive, platform-agnostic knowledge base, instruction set, and CLI toolkit for FluentCart theme, plugin, shipping, and payment gateway development.
|
|
7
|
+
|
|
8
|
+
This repository provides ready-to-use configurations, reference manuals, and code boilerplates for all major AI coding assistants (Antigravity, Cursor, Claude Code, Windsurf, Cline, Zed, GitHub Copilot), enabling them to write correct, compatible code for FluentCart out-of-the-box.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Included Skills
|
|
13
|
+
|
|
14
|
+
- **`FluentCart Developer`** (`fluentcart-developer`):
|
|
15
|
+
- **Complete Database Manual:** 34 DB migrations, all `wp_fct_*` schema tables, Eloquent ORM models, relationships, and Query Builder.
|
|
16
|
+
- **315+ Action & Filter Hooks:** 14 dedicated hook reference files covering order lifecycles, payment webhooks, cart fees, and admin UI.
|
|
17
|
+
- **15 REST API Modules (Core & Pro):** Orders, Products, Customers, Coupons, Subscriptions, Tax, Shipping, Settings, Email Notifications, Reports, Integrations, Files, Labels & Attributes, Dashboard & Utilities, Public Shop, Checkout, Customer Profile, Software Licensing (Pro), Roles & Permissions (Pro), Order Bumps (Pro).
|
|
18
|
+
- **5 Runnable Example Projects:** Custom Addon plugin, Fee Surcharge plugin, Payment Gateway plugin, Shipping Carrier, and Starter Child Theme.
|
|
19
|
+
|
|
20
|
+
- **`Lemon Squeezy Developer`** (`lemonsqueezy-developer`):
|
|
21
|
+
- **Complete JSON:API Manual:** Stores, Products, Variants, Prices, Files, Orders, and Subscriptions specifications.
|
|
22
|
+
- **HMAC-SHA256 Webhook Security:** Timing-safe raw request signature verifiers for Node.js, Next.js App Router, and PHP.
|
|
23
|
+
- **Subscriptions Lifecycle:** State transitions, pausing, cancellations, dunning retries, and hosted customer portal URLs.
|
|
24
|
+
- **Software Licensing:** Public `/activate`, `/validate`, and `/deactivate` endpoints for desktop software and plugins.
|
|
25
|
+
- **Dynamic Checkouts & Lemon.js:** API checkout generation, in-app modal overlays, and custom metadata tracking.
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Playing Cards (MCP Server)
|
|
30
|
+
|
|
31
|
+
Skills tell the model what to do. The MCP server in [`server/`](./server/README.md) gives it the tools to do it — without loading a single large markdown file into context.
|
|
32
|
+
|
|
33
|
+
| Card | Core (free) | Pro |
|
|
34
|
+
| --- | --- | --- |
|
|
35
|
+
| **Card 1 — FluentCart Pro Agent** | `fc_search_hooks`, `fc_get_db_schema` | `fc_generate_payment_gateway_boilerplate` |
|
|
36
|
+
| **Card 2 — Lemon Squeezy Developer Agent** | `ls_search_docs`, `ls_get_schema` | `ls_verify_webhook`, `ls_validate_license` |
|
|
37
|
+
|
|
38
|
+
Every session also exposes the skills catalog itself (`skills/list`, `resources/read`), so the agent reads one reference file on demand instead of the whole knowledge base.
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
cd server && npm install && npm run build
|
|
42
|
+
node dist/index.js # stdio: Claude Code, Cursor, Windsurf, Smithery CLI
|
|
43
|
+
node dist/http.js # Streamable HTTP on :8080: MCPize, Railway, Render, Fly.io
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Pro tools are not registered on a free session — the schemas never reach the client. Unlock with a Lemon Squeezy license key (`Authorization: Bearer <key>` over HTTP, `PRO_LICENSE_KEY` for local stdio). Tier resolution, marketplace gateway secrets and deployment are documented in [`server/README.md`](./server/README.md).
|
|
47
|
+
|
|
48
|
+
**Licensing:** skill content (`skills/`) is MIT and stays public for discovery and `skills.sh` indexing. The server implementation (`server/`) is BSL-1.1 — see [`server/LICENSE.md`](./server/LICENSE.md).
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## Installation & Setup
|
|
53
|
+
|
|
54
|
+
Choose the installation method that fits your environment and AI coding assistant:
|
|
55
|
+
|
|
56
|
+
### Method 1: The `skills.sh` Method (Recommended for Cursor, Claude Code, Windsurf, Antigravity)
|
|
57
|
+
|
|
58
|
+
Install this skill directly into your project's local workspace using the official `skills.sh` manager:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
# Install specific skill into current project
|
|
62
|
+
npx skills add atifjubaer/skills --skill "fluentcart-developer"
|
|
63
|
+
|
|
64
|
+
# Or run interactively without flags to pick from list
|
|
65
|
+
npx skills add atifjubaer/skills
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
### Method 2: Updating Installed Skills
|
|
71
|
+
|
|
72
|
+
To fetch and update your installed skills to the latest version on GitHub:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# Update all installed skills in current workspace via skills.sh
|
|
76
|
+
npx skills update
|
|
77
|
+
|
|
78
|
+
# Or force reinstall the latest version from GitHub
|
|
79
|
+
npx skills add atifjubaer/skills --skill "fluentcart-developer" --force
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
If you cloned this repository locally:
|
|
83
|
+
```bash
|
|
84
|
+
git pull origin main
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
### Method 3: Direct CLI Initializer & Interactive Wizard
|
|
90
|
+
|
|
91
|
+
Run the CLI command without arguments for an interactive selection prompt:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
npx fluentcart-developer
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Or pass direct command flags:
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
# Initialize both global skills and current project rules for all IDEs
|
|
101
|
+
npx fluentcart-developer init
|
|
102
|
+
|
|
103
|
+
# Setup ONLY global skills (~/.gemini/, ~/.claude/)
|
|
104
|
+
npx fluentcart-developer global
|
|
105
|
+
|
|
106
|
+
# Setup ONLY local project rules
|
|
107
|
+
npx fluentcart-developer project
|
|
108
|
+
|
|
109
|
+
# Safely remove rule markers from project and global files
|
|
110
|
+
npx fluentcart-developer remove
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
### Method 4: Manual Installation
|
|
116
|
+
|
|
117
|
+
If you prefer manual setup:
|
|
118
|
+
1. **For Antigravity / Gemini**: Copy `SKILL.md`, `references/`, and `examples/` from `skills/fluentcart-developer/` into your global Gemini config path:
|
|
119
|
+
`~/.gemini/config/skills/fluentcart-developer/`
|
|
120
|
+
2. **For Cursor / Windsurf / Cline / Zed**: Copy `.cursorrules` to your project root.
|
|
121
|
+
3. **For Claude Code**: Copy `CLAUDE.md` to your project root.
|
|
122
|
+
4. **For Web-based AIs**: Copy the content of `fluentcart-rules.md` and paste it into your chat session.
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
## Repository Folder Structure
|
|
127
|
+
|
|
128
|
+
```
|
|
129
|
+
skills/
|
|
130
|
+
├── README.md # Installation guide and repository overview
|
|
131
|
+
├── package.json # Package configuration
|
|
132
|
+
├── copy-skills.js # Automated skill sync builder
|
|
133
|
+
├── skills.sh.json # skills.sh catalog layout configuration
|
|
134
|
+
├── CLAUDE.md # Claude Code instructions
|
|
135
|
+
├── CONTRIBUTING.md # Guidelines for repository contributors
|
|
136
|
+
├── LICENSE # MIT License
|
|
137
|
+
├── bin/
|
|
138
|
+
│ └── index.js # Interactive CLI runner
|
|
139
|
+
├── .github/
|
|
140
|
+
│ └── workflows/
|
|
141
|
+
│ └── sync-docs.yml # GitHub Actions automated doc sync workflow
|
|
142
|
+
├── references/ # Root reference manuals catalog
|
|
143
|
+
├── examples/ # Standalone boilerplate code examples
|
|
144
|
+
│ ├── sample-custom-payment-gateway/
|
|
145
|
+
│ ├── sample-shipping-carrier/
|
|
146
|
+
│ └── fluentcart-starter-child-theme/
|
|
147
|
+
├── server/ # 👈 MCP server (BSL-1.1, commercial)
|
|
148
|
+
│ ├── src/
|
|
149
|
+
│ │ ├── auth.ts # Core / Pro tier resolution
|
|
150
|
+
│ │ ├── server.ts # Server factory + skills catalog
|
|
151
|
+
│ │ ├── index.ts # stdio entry
|
|
152
|
+
│ │ ├── http.ts # Streamable HTTP entry
|
|
153
|
+
│ │ └── cards/ # One folder per Playing Card
|
|
154
|
+
│ ├── scripts/ # Build bundler + protocol probe
|
|
155
|
+
│ └── Dockerfile # Build from repo root
|
|
156
|
+
└── skills/ # 👈 Skill content (MIT, public)
|
|
157
|
+
├── fluentcart-developer/ # Card 1
|
|
158
|
+
│ ├── SKILL.md
|
|
159
|
+
│ ├── references/
|
|
160
|
+
│ └── examples/
|
|
161
|
+
└── lemonsqueezy-developer/ # Card 2
|
|
162
|
+
├── SKILL.md
|
|
163
|
+
└── references/
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## Created by
|
|
169
|
+
Developed and maintained by **Fastrsoft** (Atif Jubaer).
|