@fluentcommerce/ai-skills 0.1.0

package/content/cli/skills/fluent-cli-retailer/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: fluent-cli-retailer
+description: Manage Fluent retailer lifecycle via CLI. Use for creating and listing retailers, validating profile context, and safely preparing retailer admin access for module/workflow operations.
+user-invocable: true
+allowed-tools: Bash, Read, Write, Edit, Glob, Grep
+argument-hint: <create|list> [retailer-ref] [--profile name]
+---
+
+# CLI Retailer Operations
+
+Create and inspect retailers with Fluent CLI, and ensure follow-up context is valid for deployments.
+
+## When to Use
+
+- New retailer setup
+- Listing retailers under a profile/account
+- Preparing context before module install or workflow operations
+
+## Core Commands
+
+Check available syntax first:
+
+```bash
+fluent retailer --help
+```
+
+### Create retailer
+
+```bash
+fluent retailer create <retailer-ref> \
+  --email <retailer-admin-email> \
+  --profile <profile-name>
+```
+
+### List retailers (local configs)
+
+```bash
+fluent retailer list
+```
+
+Note: `retailer list` takes NO flags — it lists all locally configured retailers across all profiles.
+
+### List retailers (remote, via profile)
+
+```bash
+fluent profile retailers <profile-name>
+```
+
+### Manual retailer registration
+
+When the CLI doesn't know about a retailer (e.g., `workflow list` fails with "retailer does not exist"), you can register it manually:
+
+```bash
+fluent profile update <profile-name> --retailer <retailer-ref> --id <retailer-id>
+```
+
+Or create the file directly:
+```json
+// ~/.fluentcommerce/<profile>/retailer.<retailer-ref>.json
+{ "id": "<id>", "ref": "<retailer-ref>", "user": "<username>" }
+```
+
+## Post-Create Validation
+
+1. Confirm retailer appears in `fluent retailer list`.
+2. Set active context:
+
+```bash
+fluent profile use <profile-name> --retailer <retailer-ref>
+fluent profile active
+```
+
+3. Proceed with module config/install only after active retailer is correct.
+
+## Important Operational Note
+
+Prefer CLI retailer creation for full operational setup. Avoid ad-hoc GraphQL retailer creation for bootstrap flows because downstream behavior can diverge from CLI-created retailer expectations.
+
+## Troubleshooting
+
+| Issue | Likely Cause | Fix |
+|---|---|---|
+| Retailer create fails auth | Wrong profile credentials | Verify profile and retry with correct account admin |
+| Retailer not visible | Wrong profile/account | Re-check profile and rerun list |
+| Subsequent module commands fail | Active retailer not set | Run `fluent profile use ... --retailer ...` |

package/content/cli/skills/fluent-cli-settings/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: fluent-cli-settings
+description: Manage Fluent CLI settings operations. Use for listing and reading settings by profile/retailer context, wildcard filtering, and validating missing/incorrect setting values before or after module/workflow changes.
+user-invocable: true
+allowed-tools: Bash, Read, Write, Edit, Glob, Grep
+argument-hint: <list|get> [setting-name-or-pattern] [--profile name] [--retailer ref]
+---
+
+# CLI Settings Operations
+
+Read and validate Fluent settings using CLI commands, with profile/retailer context safety checks.
+
+## When to Use
+
+- User asks to list current settings
+- User asks to read a specific setting key/value
+- Validate required settings after module/workflow deployment
+- Compare settings across environments via profile+retailer context
+
+## Prerequisites
+
+- Active or provided profile
+- Retailer context for retailer-scoped settings
+
+Always verify context first:
+
+```bash
+fluent profile active
+```
+
+## Core Commands
+
+Use command help first if your CLI build differs:
+
+```bash
+fluent setting --help
+```
+
+### List settings (summary view)
+
+```bash
+fluent setting list -p <profile-name> -r <retailer-ref>
+```
+
+With wildcard filtering (SQL-style `%` wildcards, not glob):
+
+```bash
+fluent setting list -p <profile-name> -r <retailer-ref> --name "%webhook%"
+fluent setting list -p <profile-name> -r <retailer-ref> --name "%manifest%" --json
+fluent setting list -p <profile-name> -r <retailer-ref> --context retailer
+```
+
+| Flag | Description |
+|------|-------------|
+| `-n, --name` | Filter by name (`%` wildcards). Repeatable. |
+| `-f, --first` | Limit results (disables auto-pagination) |
+| `--context` | Filter: `account`, `retailer`, or `all` |
+| `-j, --json` | Output as JSON (default: false) |
+
+### Get settings (full detail with values)
+
+```bash
+fluent setting get -p <profile-name> -r <retailer-ref>
+fluent setting get -p <profile-name> -r <retailer-ref> --name "%order%" --json
+```
+
+| Flag | Description |
+|------|-------------|
+| `-n, --name` | Filter by name (`%` wildcards). Repeatable. |
+| `-f, --first` | Limit results (disables auto-pagination) |
+| `--context` | Filter: `account`, `retailer`, or `all` |
+| `-j, --json` | Output as JSON (default: true) |
+
+**Difference:** `list` = summary (name, context, type), `get` = full detail including `value` and `lobValue` (for JSON settings).
+
+## Validation Workflow
+
+1. `fluent setting list` for broad view.
+2. `fluent setting get` for each required key.
+3. Compare values with expected module/workflow config.
+4. Report missing keys and mismatches.
+
+Suggested output format:
+
+```
+Setting: webhook.order.created
+Status: FOUND
+Value: https://...
+Context: retailer=<retailer-ref>
+```
+
+## Common Checks
+
+- Webhook endpoints
+- Carrier defaults
+- Consignment prefixes
+- Feature flags
+- Cancellation reason sources
+
+## Troubleshooting
+
+| Issue | Likely Cause | Fix |
+|---|---|---|
+| Empty list | Wrong profile/retailer context | Verify `fluent profile active` and rerun with explicit `--profile/--retailer` |
+| Setting not found | Key mismatch or wrong scope | Check exact name/case and target retailer |
+| Unexpected value | Drift between environments | Compare with source env and re-apply expected config |