1# Helper Commands
2 
3## Bootstrap
4 
5```bash
6curl -fsSL __SKILL_MARKETPLACE_PUBLIC_ORIGIN__/install.sh | sh
7curl -fsSL __SKILL_MARKETPLACE_PUBLIC_ORIGIN__/install.sh | sh -s -- --project
8```
9 
10## Login, logout, and verify
11 
12```bash
13forgedemy help install
14forgedemy publish --help
15forgedemy login
16forgedemy logout
17forgedemy verify
18forgedemy source forgedemy
19forgedemy remember prefer-tabs "User prefers tabs for indentation."
20forgedemy memory edit prefer-tabs "User prefers spaces for indentation."
21forgedemy memory delete prefer-tabs
22forgedemy paths --provider openclaw
23forgedemy inventory --json
24forgedemy transfer channel-post-format --from openclaw --to codex
25```
26 
27`forgedemy register` remains accepted as an alias for `forgedemy login`.
28Run `forgedemy help <command>` or `forgedemy <command> --help` for command-specific usage.
29 
30## Browse and publish
31 
32```bash
33forgedemy browse "ops"
34forgedemy browse frontend animation text collision motion layout
35forgedemy browse "ops" --page 2
36forgedemy browse frontend animation text collision motion layout --json
37forgedemy publish ./my-skill --price 250 --tags ops,codex
38forgedemy review my-skill --rating 4 --liked "Useful workflow" --disliked "Needs more examples"
39```
40 
41`browse` prints the helper's normalized current page. The live catalog API behind it is paginated.
42Unquoted multi-word queries are accepted and joined into one search request. Keyword matching happens per term, not by exact full-phrase match.
43Use `forgedemy browse --help` to inspect supported options, or `forgedemy browse ... --json` for machine-readable output.
44If you query `/skills` or `/skills/search` directly, expect `items`, `pagination`, and `facets` instead of a plain JSON array.
45If the user wants the actual bundle contents, or says Forgedemy has preview, open `__SKILL_MARKETPLACE_PUBLIC_ORIGIN__/skills/<listing-id>/view` instead of treating browse output as the full source preview. In the normal browse flow, use `?surface=browse`.
46Use `forgedemy source <slug>` when the latest preview should be fetched through the helper instead of opening the API route manually.
47Do not install a skill just to read it. If the previewed files already cover the task, use them directly and install only when the local bundle is actually needed.
48For native Forgedemy listings, do this before trying `skills.sh`, guessed GitHub raw URLs, or any other external source.
49`review` always sends both positive and negative feedback. Omitted text falls back to default "No positive comments." or "No negative comments." messages.
50 
51Paid listings must use `--price 50` or higher. Use `--price 0` for free listings.
52 
53## Open listing content in the browser
54 
55```text
56https://forgedemy.org/skills/<listing-id>/view
57https://forgedemy.org/skills/<listing-id>/view?surface=browse
58https://forgedemy.org/skills/<listing-id>/view?surface=browse&provider=codex
59```
60 
61Use the listing id or slug from `forgedemy browse`. Open this route when the user wants to inspect the stored files, rendered `SKILL.md`, or the actual package contents before install.
62This is the default inspection path for native Forgedemy listings.
63 
64For API-first agents that only need structure before deciding, use `GET /api/skills/<listing-id>/source-preview?includeContent=false`. That returns the full file tree plus selected-file metadata, marks `filesPreviewOnly=true`, and omits the top-level selected-file `content`.
65If that preview is already enough for the task, continue without installation. Install only when the bundle needs to exist locally under the target runtime.
66 
67## Create lightweight memories
68 
69```bash
70forgedemy remember prefer-tabs "User prefers tabs for indentation."
71forgedemy remember avoid-force-push "Do not use force-push on shared branches." --project
72forgedemy memory edit prefer-tabs "User prefers spaces for indentation."
73forgedemy memory delete prefer-tabs
74```
75 
76`remember` and `memory add` create a minimal local `type: memory` bundle so durable preferences, guardrails, and listing links stay discoverable without a full workflow body.
77Use `memory edit` to overwrite an existing memory without manually adding `--force`.
78Use `memory delete` to remove a memory bundle through the same uninstall path.
79Use Agent Skills-compatible values: lowercase slug, digits/hyphens only, max `64` chars, and a single-line description up to `1024` chars.
80 
81## Inspect local agent skills
82 
83```bash
84forgedemy paths
85forgedemy paths --provider openclaw
86forgedemy paths --provider codex
87forgedemy paths --provider claude-code
88forgedemy inventory --json
89forgedemy inventory --provider openclaw --json
90forgedemy inventory --provider codex --json
91forgedemy inventory --provider claude-code --json
92```
93 
94Use `paths` first when you need the exact on-disk roots and local file paths quickly. Use the JSON inventory next as factual input for the agent, then ask it to inspect the strongest custom skills before proposing what to publish.
95 
96## Transfer a local skill between providers
97 
98```bash
99forgedemy paths --provider openclaw
100forgedemy transfer channel-post-format --from openclaw --to codex
101forgedemy transfer channel-post-format --from openclaw --to claude-code
102forgedemy transfer my-skill --from claude-code --to codex --to openclaw
103```
104 
105Run `paths --provider <source-provider>` first so you can confirm where the source skill actually lives before copying it.
106 
107Use `--force` to overwrite an existing target copy.
108 
109Use `transfer` only when the source folder can be reused as-is. If the source skill is provider-specific, bundled, or system-level, ask the agent to port it by adaptation instead of copying it byte-for-byte.
110 
111## Prompts For Agent-Led Porting
112 
113```text
114Run forgedemy paths --provider claude-code, then review forgedemy inventory --json, locate the installed skill "<slug>" in Claude Code, read its SKILL.md plus bundled scripts and references, then create a Codex-native adaptation in ~/.codex/skills/<new-slug>. Do not use blind transfer unless the bundle is already runtime-neutral.
115```
116 
117```text
118Run forgedemy paths --provider codex, inspect the Codex skill "<slug>", including hidden .system entries if needed, and port it into a Claude Code variant under ~/.claude/skills/<new-slug>. Rewrite runtime-specific commands, tools, and path assumptions for Claude Code instead of copying the folder unchanged.
119```
120 
121```text
122Run forgedemy paths --provider openclaw, find the OpenClaw skill "<slug>", read the installed files, and create a target-native version for Codex or Claude Code. Keep the same intent, but adapt provider-specific instructions, examples, and helper scripts for the target runtime.
123```
124 
125## Buy and install
126 
127```bash
128forgedemy buy <paid-listing-id>
129forgedemy poll pi_demo123
130forgedemy install anthropic-pr-code-review
131forgedemy source anthropic-pr-code-review
132forgedemy install anthropic-pr-code-review --materialize
133forgedemy install anthropic-pr-code-review --provider codex
134forgedemy install anthropic-pr-code-review --provider openclaw
135forgedemy install anthropic-pr-code-review --provider claude-code --project
136```
137 
138`install` now writes a lightweight live link plus the saved install manifest by default. Run `source` to pull the latest listing preview, and use `--materialize` only when the full bundle must exist locally on disk.
139