Skip to content

docs(skill): restructure install guide — CLI/MCP first, add tool restrictions#978

Merged
huacnlee merged 3 commits into
mainfrom
better-skill
May 11, 2026
Merged

docs(skill): restructure install guide — CLI/MCP first, add tool restrictions#978
huacnlee merged 3 commits into
mainfrom
better-skill

Conversation

@huacnlee
Copy link
Copy Markdown
Member

Summary

  • Reorder steps: connect to Longbridge platform (CLI or MCP) first, install Skill second — the old order had Skill as Step 1, which is useless without data access
  • Lead intro with terminal-based AI tools (Claude Code, Codex, opencode, OpenClaw) as the recommended/quickest path
  • Clarify CLI vs MCP framing: CLI = best experience but needs local install; MCP = easier, just a URL
  • Add Known restrictions by tool section with clear guidance and screenshots:
    • Claude Desktop Chat mode: network whitelist blocks CLI/MCP — switch to Code tab instead (screenshot added)
    • Codex Cloud mode: same network restrictions — must select "Work locally" (screenshot added)
    • Claude.ai / ChatGPT.com web: redirect to Claude Desktop Code tab
  • Add mainland China accelerated MCP endpoint (https://openapi.longbridge.cn/mcp) to English version
  • Rename section heading "Connect your Longbridge account" → "Connect to the Longbridge platform"
  • All changes synced across en / zh-CN / zh-HK

Test plan

  • Preview skill install page in all three locales
  • Verify screenshots render correctly
  • Check all links resolve (CLI reference, Claude Desktop download)

🤖 Generated with Claude Code

huacnlee and others added 3 commits May 11, 2026 14:44
…rictions

- Reorder steps: connect to platform (CLI or MCP) first, install Skill second
- Lead with terminal-based tools (Claude Code, Codex, opencode, OpenClaw) as recommended path
- Clarify CLI vs MCP: CLI best experience, MCP easier to connect
- Add "Known restrictions" section replacing generic "why it doesn't work" note
  - Claude Desktop Chat mode: guide users to switch to Code tab (with screenshot)
  - Codex: must select "Work locally", not Cloud (with screenshot)
  - Claude.ai / ChatGPT.com web: redirect to Claude Desktop Code tab
- Add mainland China accelerated MCP endpoint to English version
- Rename "Connect your Longbridge account" → "Connect to the Longbridge platform"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@huacnlee huacnlee merged commit f40ca23 into main May 11, 2026
2 checks passed
@huacnlee huacnlee deleted the better-skill branch May 11, 2026 06:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant