Skip to content

docs(skills): durations from the test node, ~/urbex-work everywhere, the plugin from the terminal, Cloudflare asked only when wanted - #96

Open
Teg79 wants to merge 2 commits into
mainfrom
docs/skills-alignment
Open

Teg79 wants to merge 2 commits into
mainfrom
docs/skills-alignment

Conversation

@Teg79

@Teg79 Teg79 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Summary

The four points of #57:

  • Durations, from the latest test-node run (the Forgejo spike, 2026-11-17): a first bootstrap 1212 s (233 s of it the LXC template), a first apply of an environment 342 s (two services: LXCs, build, deploy), a later apply a minute or two, promote 82 s.
    • skills/setup/SKILL.md: "about twenty minutes the first time (1212 s …), a minute or two when it runs again".
    • skills/cli/SKILL.md (Following a long command): per command, instead of "up to twenty".
    • docs/getting-started/with-the-cli.md and with-claude-code.md: the figures next to "about twenty minutes", and the first apply's six minutes.
  • The default workspace is ~/urbex-work everywhere: the cli skill, check-prerequisites.sh (which also finds an existing ~/urbex-workspace when it's the only one), docs/demo/README.md. urbex-op's own default changes in fix(operator): urbex-op's default workspace is ~/urbex-work, as in the docs urbex-cli#125.
  • Install from the terminal: claude plugin marketplace add urbforge/urbex, claude plugin install urbex@urbex, and /reload-plugins (or a restart) before the skills are seen.
  • Cloudflare: the setup skill now goes on without it and says in one line it can be added later (Quick Tunnel or own zone), asking only when the user wants public addresses or names a Cloudflare domain. The getting-started step says the same. This is my proposal for the issue's open question: confirm or change it in review.
  • Plugin 0.2.2: plugin.json, the cli skill's version line, CHANGELOG.md (Plugin 0.2.2 and a Docs line under Unreleased), docs/upgrading.md's table.

Depends on urbforge/urbex-cli#125.

Why

#57, from the end-to-end test urbforge/redemptor#46: the skills and docs said things the CLI didn't do.

Tests I ran

  • tests/plugin-scripts.sh: passes (CHANGELOG.md has plugin 0.2.2). check-prerequisites.sh runs.
  • No ~/urbex-workspace left in the skills or docs, except where the older default is named on purpose.
  • Not run: the plugin's setup end to end with the new Cloudflare wording.

Checklist before review

  • Linked issue, Conventional Commit title
  • Plugin version bumped (0.2.2), CHANGELOG entry
  • No secrets, tokens or private addresses

Fixes #57

🤖 Generated with Claude Code

https://claude.ai/code/session_0182yxsfwRowwnxCfgrQwjnA

Teg79 and others added 2 commits November 18, 2026 14:34
…the plugin from the terminal, Cloudflare asked only when wanted

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0182yxsfwRowwnxCfgrQwjnA
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.

docs(skills): align durations, default workspace, install steps and the Cloudflare question

2 participants