docs: clarify marketplace installs

.changeset/clear-marketplace-installs.md

@@ -0,0 +1,5 @@
+---
+"kilo-code": patch
+---
+
+Explain Marketplace item types, installation scopes, destination files, and MCP security before installation.

packages/kilo-docs/lychee.toml

@@ -50,6 +50,8 @@ exclude = [
   '^https?://api\.apertis\.ai/v1/?$',
   # Redirects to authenticated Google Cloud console
   '^https?://console\.cloud\.google\.com',
+  # Linear intermittently returns 503 to CI link checks.
+  '^https?://linear\.app/?$',
   # Consistently times out in CI
   '^https?://opncd\.ai',
   '^https?://zod\.dev/v4/changelog',

packages/kilo-docs/source-links.md

@@ -123,10 +123,15 @@
   <!-- packages/opencode/src/cli/cmd/providers.ts -->
 - <https://kilo.ai/docs/ai-providers#custom-provider>
   <!-- packages/kilo-vscode/webview-ui/src/components/settings/CustomProviderDialog.tsx -->
+- <https://kilo.ai/docs/automate/mcp/what-is-mcp>
+  <!-- packages/kilo-vscode/webview-ui/src/components/marketplace/InstallModal.tsx -->
 - <https://kilo.ai/docs/code-with-ai/platforms/vscode/whats-new>
   <!-- packages/kilo-vscode/webview-ui/src/components/migration/MigrationWizard.tsx -->
 - <https://kilo.ai/docs/customize/custom-subagents>
   <!-- packages/opencode/src/config/config.ts -->
+- <https://kilo.ai/docs/customize/marketplace>
+  <!-- packages/kilo-vscode/webview-ui/src/components/marketplace/InstallModal.tsx -->
+  <!-- packages/kilo-vscode/webview-ui/src/components/marketplace/MarketplaceListView.tsx -->
 - <https://kilo.ai/docs/customize/workflows>
   <!-- packages/opencode/src/config/config.ts -->
 - <https://kilo.ai/gateway>

packages/kilo-i18n/src/en.ts

@@ -41,9 +41,26 @@ export const dict = {
   "marketplace.card.showMore": "Show more",
   "marketplace.card.showLess": "Show less",
   "marketplace.install.title": "Install {{name}}",
-  "marketplace.install.scope": "Scope",
+  "marketplace.install.scope": "Where should this be available?",
   "marketplace.install.scope.project": "Project",
   "marketplace.install.scope.global": "Global",
+  "marketplace.install.scope.project.description":
+    "Only this project. The installed files can be committed and shared with your team.",
+  "marketplace.install.scope.global.description": "All projects on this machine. Stored in your user configuration.",
+  "marketplace.install.destination": "Installation destination",
+  "marketplace.install.about.mcp":
+    "An MCP server gives Kilo additional tools for working with external services or local programs.",
+  "marketplace.install.about.agent": "An agent adds a reusable role with its own instructions and permissions.",
+  "marketplace.install.about.skill": "A skill adds task-specific instructions and resources that Kilo can load when needed.",
+  "marketplace.install.mcp.warning":
+    "MCP servers can run local commands or connect to external services. Kilo will ask for permission before using their tools unless your permissions allow them automatically.",
+  "marketplace.install.project.warning":
+    "Project files may be committed to version control. Do not store secrets here unless the configuration references an environment variable.",
+  "marketplace.install.learnMore": "Learn how Marketplace installs work",
+  "marketplace.install.learnMcp": "Learn more about MCP",
+  "marketplace.install.installedAt": "Installed to {{path}}",
+  "marketplace.intro": "Install reusable agents, skills, and MCP tools for one project or every project.",
+  "marketplace.intro.learnMore": "About Marketplace",
   "marketplace.install.prerequisites": "Prerequisites",
   "marketplace.install.installing": "Installing...",
   "marketplace.install.cancel": "Cancel",