{"id":50365669,"url":"https://github.com/bymilesai/skills","last_synced_at":"2026-05-30T04:02:03.896Z","repository":{"id":342189882,"uuid":"1173185643","full_name":"bymilesai/skills","owner":"bymilesai","description":"Miles (bymiles.ai) Skill. Design beautiful custom WordPress websites with Miles.","archived":false,"fork":false,"pushed_at":"2026-05-29T19:55:20.000Z","size":112,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"trunk","last_synced_at":"2026-05-29T20:17:10.581Z","etag":null,"topics":["agents","wordpress"],"latest_commit_sha":null,"homepage":"https://bymiles.ai","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bymilesai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-05T05:03:44.000Z","updated_at":"2026-05-29T19:11:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bymilesai/skills","commit_stats":null,"previous_names":["bymilesai/skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bymilesai/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymilesai%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymilesai%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymilesai%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymilesai%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bymilesai","download_url":"https://codeload.github.com/bymilesai/skills/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymilesai%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33679306,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","wordpress"],"created_at":"2026-05-30T04:02:00.550Z","updated_at":"2026-05-30T04:02:03.884Z","avatar_url":"https://github.com/bymilesai.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Miles (bymiles.ai) Agent Skill\n\nDesign and build beautiful WordPress websites with [Miles](https://bymiles.ai). This skill allows coding agents such as Codex, Claude Code, OpenCode, Cursor, and similar tools to create professional WordPress websites — from initial brief through design direction selection to a fully built WordPress site.\n\nMiles provides instant cloud sandboxes for WordPress so you can build and experiment with WordPress immediately. When you're ready you can export to a local environment or push to a host.\n\n## What it does\n\nMiles can conduct a design interview, generates a strategic website brief, create multiple design directions for review. You or your agent can decide which design to build and continue to iterate on the design and structure.\n\n## Install\n\nThe easiest path is to ask your coding agent to install Miles from the public setup URL:\n\n\u003e \"Install Miles from start.bymiles.ai\"\n\nYour agent should fetch `https://start.bymiles.ai` as Markdown or plain text, propose one install command, ask for your approval, then tell you to ask for Miles. It should not open the page in a browser during install unless text fetching fails or you explicitly ask to view it.\n\nThe universal install command is:\n\n```bash\ncurl -fsSL https://start.bymiles.ai/install.sh | sh\n```\n\nFor an inspect-first install:\n\n```bash\ncurl -fsSL https://start.bymiles.ai/install.sh -o /tmp/miles-install.sh\nsh /tmp/miles-install.sh\n```\n\nTo preview the install without writing files:\n\n```bash\ncurl -fsSL https://start.bymiles.ai/install.sh | sh -s -- --dry-run\n```\n\nThe dry run shows the source archive, checksum status, destination directories, launcher paths, bundled runtime status, JavaScript fallback status, and payload file list.\nIt performs read-only GETs for the install and payload manifests unless a local source override is provided; if those fetches fail, it still prints the local plan and says the payload could not be inspected.\n\nTo install only for Codex:\n\n```bash\ncurl -fsSL https://start.bymiles.ai/install.sh | sh -s -- --agent codex\n```\n\nThis installs the `miles/` skill into common agent skill directories such as:\n\n```\n~/.agents/skills/miles/\n~/.claude/skills/miles/\n```\n\nMiles follows the Vercel skills CLI convention: Codex, Cursor, OpenCode, and other universal agents use `~/.agents/skills`; Claude Code uses `~/.claude/skills`.\n\nIt also creates `~/.miles/bin/miles-skill`, a local helper for status, update checks, updates, and uninstall. The installer reads `https://start.bymiles.ai/version.json` and verifies the source archive SHA-256 when the manifest publishes `sourceSha256`.\n\nSecurity summary: [INSTALL_SECURITY.md](INSTALL_SECURITY.md)\n\nAfter install, your agent should verify Miles and complete login if needed. It should not ask you to run `miles login` manually. Once Miles is authenticated, tell your agent what you want to build. A useful prompt includes the business or project, desired style, primary visitor goal, and any existing WordPress URL.\n\n\u003e \"Use Miles to design a warm, modern website for my yoga studio in Portland that helps visitors book intro classes.\"\n\nIf your agent does not see the new skill, start a new chat or reload the agent window.\n\nIf you already use the Vercel skills CLI, this still works:\n\n```bash\nnpx skills add bymilesai/skills\n```\n\nTo validate a specific branch or tag with the skills CLI before it becomes the default install:\n\n```bash\nnpx skills add bymilesai/skills#branch-or-tag --skill miles\n```\n\nSee [INSTALL_FOR_AGENTS.md](INSTALL_FOR_AGENTS.md) for the agent-facing install protocol and [start.bymiles.ai.md](start.bymiles.ai.md) for the content intended to be served at `https://start.bymiles.ai`.\n\n## Requirements\n\n- A supported macOS, Linux, or Windows platform for the bundled Miles CLI runtime\n- Node.js 20+ only when using the JavaScript fallback, local source overrides, or unsupported platforms\n- A Miles AI account — sign up at [bymiles.ai](https://bymiles.ai)\n\nThe skill source includes an auditable zero-dependency JavaScript CLI. Versioned releases publish prebuilt Miles CLI executables so normal installs do not require users to have Node installed.\n\n## Usage\n\nOnce installed, just ask your AI agent to build a website with Miles:\n\n\u003e \"Use Miles to design a website for my yoga studio in Portland.\"\n\nThe skill handles authentication, the design conversation with Miles, and the full build process. Your agent will relay Miles' questions to you and present design options for your approval. You can continue to make changes to your WordPress site with Miles.\n\nThe bundled CLI lives at `miles/scripts/miles`. Use `doctor --json` to check the local setup. Set `MILES_HOME` when you want an isolated clean-machine test:\n\n```bash\nexport MILES_HOME=/tmp/miles-skill-smoke\nexport MILES_CLI=/path/to/installed/miles/scripts/miles\n\"$MILES_CLI\" doctor --json\n```\n\nThe installer also writes a lifecycle helper:\n\n```bash\n~/.miles/bin/miles-skill status --json\n~/.miles/bin/miles-skill check-update --json\n~/.miles/bin/miles-skill update\n~/.miles/bin/miles-skill uninstall\n```\n\nAgents should run `check-update --json` when Miles is first used in a session. The check is cached for 24 hours and should only prompt the user when it returns `\"shouldPrompt\": true`. Urgent updates may keep returning `\"shouldPrompt\": true` from the cached result until the user updates. Updates and uninstall always require user approval.\n\nWhen files under `miles/` change during normal development, regenerate the payload manifest before testing:\n\n```bash\n/opt/homebrew/bin/node scripts/generate-payload-manifest.mjs\n```\n\n## Releasing Skill Updates\n\nSkill updates should ship as versioned releases, not moving branch archives. The release workflow mirrors the Miles plugin release model:\n\n1. Run the release script from a clean `trunk` checkout.\n2. The script bumps `version.json`, `install.sh`, and `payload-manifest.json`.\n3. The script opens and merges a release PR, then pushes a `skill-v\u003cversion\u003e` tag.\n4. GitHub Actions packages an immutable `miles-skill-\u003cversion\u003e.tar.gz` release asset plus Bun-compiled CLI binaries, computes SHA-256 values, and writes those checksums back to `trunk`'s `version.json`.\n5. Installed helpers compare their receipt version with `https://start.bymiles.ai/version.json` and prompt users when a newer release is available.\n\nDefault patch release:\n\n```bash\n/opt/homebrew/bin/node scripts/release-skill.mjs patch\n```\n\nUrgent release that keeps prompting users until they update:\n\n```bash\n/opt/homebrew/bin/node scripts/release-skill.mjs --urgent patch\n```\n\nPreview the next version without changing files:\n\n```bash\n/opt/homebrew/bin/node scripts/release-skill.mjs --dry-run patch\n```\n\nThe workflow looks like:\n\n1. **Authentication** — agents use `miles login --json`, show the device code, then immediately run `miles login --poll --json` while you authorize\n2. **Create site** — `miles create-site \"description\"` starts a conversation with Miles\n3. **Discovery** — Miles asks questions, your agent relays them to you, sends your answers back\n4. **Brief review** — Miles presents a design brief for your approval\n5. **Design directions** — Miles generates multiple design directions with preview URLs\n6. **Build** — You pick a direction, Miles builds the full site in both HTML and as a WordPress block theme\n7. **Export** — Download as static HTML site or export a full WordPress sandbox instance you can drop into Local or WP Studio\n8. **Edit** - Continue to make direct edits to your WordPress using Miles and the cloud sandbox it provides\n\nSee [commands.md](miles/commands.md) for the full command reference, [examples.md](miles/examples.md) for workflow examples, and [smoke-checklist.md](miles/smoke-checklist.md) for clean-environment validation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbymilesai%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbymilesai%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbymilesai%2Fskills/lists"}