Skip to content

docs(skills): add Bolt install steps to the Agent Skills pages - #427

Open
raffaelefarinaro wants to merge 1 commit into
mainfrom
docs/agent-skills-app-builders
Open

docs(skills): add Bolt install steps to the Agent Skills pages#427
raffaelefarinaro wants to merge 1 commit into
mainfrom
docs/agent-skills-app-builders

Conversation

@raffaelefarinaro

Copy link
Copy Markdown
Contributor

What

Adds Bolt to the per-agent install picker on the Agent Skills pages, under a new AI app builders group.

Bolt imports Agent Skills straight from a public GitHub repo, so people building there can install the Scandit skills without a terminal — npx plugins add scandit/skills is useless to them. The steps are:

In Bolt, open the plus menu next to the prompt → Skills → Manage skills (inside a project: gear icon → Skills). Then Add skill → From GitHub, paste the repository URL (copy the block below), pick the skill under Skill folder name and click Create.

Verified by hand in the Bolt UI: pasting https://github.com/scandit/skills populates the Skill folder name dropdown and imports the selected skill.

Changes

  • SkillsCallout/agents.tsx — Bolt entry, plus three new optional fields on AgentInstall: group (optgroup in the picker), frameworks (which framework pages offer the entry) and docs (link to the platform's own instructions).
  • SkillsCallout/ManualInstall.tsx — filters entries by framework, renders optgroups when any grouped entry applies, and shows the docs link.
  • SkillsPage/index.tsx + styles.module.css — a pointer under the one-command install ("Building in an AI app builder instead? The same skills import straight from GitHub into Bolt"), and a reworded manual-install intro. Both are derived from the entries, so they stay correct as builders are added or removed.

Gated to Web: these platforms only generate web apps, so nothing changes on the iOS, Android, Flutter, React Native, Cordova, Capacitor, KMP or .NET pages.

Platforms tested and left out

  • Lovable — its GitHub import zips the whole ref and applies the 200-file / 10 MB package limit before scoping to the linked subdirectory, so scandit/skills (973 files) is rejected with "ZIP file contains too many files". The repo root URL, the documented tree/<branch>/skills/<slug> form and uploading GitHub's repo zip all fail. A hand-built zip of a single skill folder (SKILL.md at the root + references/) imports fine via the Archive tab, so the fix on our side would be publishing per-skill zips as release assets in scandit/skills — or per-skill orphan branches, if we want a paste-a-URL flow. Reported to Lovable support.
  • Replit — installs from its Discover pane, which reads from skills.sh where all 80 Scandit skills are published, but they are not surfaced there yet.

Both re-add as a single entry in AGENT_INSTALLS once they work.

Verification

yarn typecheck, yarn build and cspell all pass. Checked the built HTML: the Web page renders the new group and copy, and no other framework page is affected.

Bolt imports Agent Skills from a public GitHub repo, so the Scandit plugin
can be installed there without a terminal. Add it to the per-agent install
picker under a new 'AI app builders' group, gated to Web since these
platforms only generate web apps.

The picker entries gain an optional framework filter, an optgroup label and
a link to the platform's own instructions. Verified in the Bolt UI: the repo
URL plus the skill-folder dropdown imports a single skill.

Lovable and Replit were tested and left out for now — Lovable rejects the
repo (its GitHub import applies a 200-file limit to the whole repository
before scoping to the linked skill folder), and our skills are not
discoverable in Replit's Discover pane yet.
@github-actions

Copy link
Copy Markdown
PR Preview Action v1.8.1

🚀 View preview at
https://Scandit.github.io/data-capture-documentation/pr-preview/pr-427/

Built to branch gh-pages at 2026-08-20 15:32 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

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