From 572e51bd582f649693de060e541ce83c8fdccf8b Mon Sep 17 00:00:00 2001 From: Roy Osherove <575051+royosherove@users.noreply.github.com> Date: Mon, 18 May 2026 15:38:59 +0000 Subject: [PATCH] chore(bootstraps): move BOOTSTRAP-SKILLS.md from essential to optional The openclaw pack now pre-installs the loki-skills library on EC2 bootstrap (PR #64), so the manual BOOTSTRAP-SKILLS.md flow is no longer essential -- it's a recovery path. - bootstraps/essential/BOOTSTRAP-SKILLS.md -> bootstraps/optional/BOOTSTRAP-SKILLS.md - Reframe the file's preamble: 'Optional / Recovery', list the recovery triggers (missing git, clone failure, origin mismatch, non-openclaw pack), tell users to skip if .bootstrapped-skills already exists. - README.md: drop from essential list, add to optional list with a note that the openclaw pack auto-installs. - deploy/README.md: drop from essential bootstrap table. - wiki/Bootstrap-Scripts-Guide.md: move section from Essential to Optional, update description to describe it as manual/recovery. - bootstraps/essential/BOOTSTRAP-MCPORTER.md: update cross-reference path to ../optional/BOOTSTRAP-SKILLS.md. deploy/brain/BOOTSTRAP.md unchanged: it points at an external URL on inceptionstack/loki-agent (different repo), and the agent now skips that step naturally because the openclaw pack pre-writes the .bootstrapped-skills marker. --- README.md | 2 +- bootstraps/essential/BOOTSTRAP-MCPORTER.md | 2 +- .../{essential => optional}/BOOTSTRAP-SKILLS.md | 17 +++++++++++++++-- deploy/README.md | 1 - wiki/Bootstrap-Scripts-Guide.md | 6 +++--- 5 files changed, 20 insertions(+), 8 deletions(-) rename bootstraps/{essential => optional}/BOOTSTRAP-SKILLS.md (82%) diff --git a/README.md b/README.md index 425d733..3eaddb5 100644 --- a/README.md +++ b/README.md @@ -152,7 +152,6 @@ Available essential bootstraps: - **BOOTSTRAP-PLAYWRIGHT** — Sets up Playwright browser automation - **BOOTSTRAP-SECRETS-AWS** — Configures AWS secrets and credential management - **BOOTSTRAP-SECURITY** — Establishes security protocols and guidelines -- **BOOTSTRAP-SKILLS** — Configures skills and capabilities ### Step 3: Run the Optional Bootstraps @@ -164,6 +163,7 @@ Available optional bootstraps: - **BOOTSTRAP-GITHUBACTION-CODE-REVIEW** — Integrates GitHub Actions with automated code review - **BOOTSTRAP-PIPELINE-NOTIFICATIONS** — Sets up CI/CD pipeline notifications +- **BOOTSTRAP-SKILLS** — Manual install / recovery for the loki-skills library (auto-installed by the `openclaw` pack) - **BOOTSTRAP-WEB-UI** — Configures the web user interface - **OPTIMIZE-TOO-LARGE-CONTEXT** — Optimization strategies for large context windows diff --git a/bootstraps/essential/BOOTSTRAP-MCPORTER.md b/bootstraps/essential/BOOTSTRAP-MCPORTER.md index 0abdd56..5750f80 100644 --- a/bootstraps/essential/BOOTSTRAP-MCPORTER.md +++ b/bootstraps/essential/BOOTSTRAP-MCPORTER.md @@ -98,7 +98,7 @@ This is your cheat sheet — future-you will thank present-you. ## Pi-Specific Configuration -**Not applicable.** Pi has no MCP support. MCPorter cannot be used with Pi. For extended capabilities, use Pi's TypeScript extensions system instead — see `BOOTSTRAP-SKILLS.md`. +**Not applicable.** Pi has no MCP support. MCPorter cannot be used with Pi. For extended capabilities, use Pi's TypeScript extensions system instead — see `../optional/BOOTSTRAP-SKILLS.md`. ## IronClaw-Specific Configuration diff --git a/bootstraps/essential/BOOTSTRAP-SKILLS.md b/bootstraps/optional/BOOTSTRAP-SKILLS.md similarity index 82% rename from bootstraps/essential/BOOTSTRAP-SKILLS.md rename to bootstraps/optional/BOOTSTRAP-SKILLS.md index e242cbd..1dbf04f 100644 --- a/bootstraps/essential/BOOTSTRAP-SKILLS.md +++ b/bootstraps/optional/BOOTSTRAP-SKILLS.md @@ -1,8 +1,21 @@ -# BOOTSTRAP-SKILLS.md — Skills Library Setup +# BOOTSTRAP-SKILLS.md — Skills Library Setup (Optional / Recovery) > **Applies to:** All agents (with agent-specific sections below) -> **Run this once on first boot.** If `memory/.bootstrapped-skills` exists, skip — you've already done this. +> **You probably don't need to run this.** As of PR #64, the `openclaw` +> pack pre-installs the loki-skills library automatically during EC2 +> bootstrap and writes `memory/.bootstrapped-skills` for you. This doc +> is kept as a **manual recovery path** for when: +> +> - the auto-install was skipped (e.g. `git` missing, clone failure, +> origin mismatch, empty corrupt repo) — see `packs/openclaw/install.sh` +> - you're running a non-openclaw pack that hasn't wired its own skills +> install yet (hermes, nemoclaw, pi, ironclaw, kiro-cli, codex-cli, +> roundhouse, claude-code) +> - you want to re-clone or move to a fork via `LOKI_SKILLS_REPO_URL` +> +> **Run this only if `memory/.bootstrapped-skills` is absent.** If it +> exists, skills are already set up — skip. ## 1. Install Skills diff --git a/deploy/README.md b/deploy/README.md index 62073b5..714bea8 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -83,7 +83,6 @@ These set up security baselines, coding guidelines, MCP tools, memory search, an | Bootstrap | What It Does | |-----------|-------------| | `BOOTSTRAP-SECURITY.md` | Security hardening + AWS Budgets alerts | -| `BOOTSTRAP-SKILLS.md` | Installs AWS infrastructure skills | | `BOOTSTRAP-MCPORTER.md` | Sets up MCP server tooling | | `BOOTSTRAP-CODING-GUIDELINES.md` | Coding standards and project conventions | | `BOOTSTRAP-SECRETS-AWS.md` | AWS Secrets Manager integration | diff --git a/wiki/Bootstrap-Scripts-Guide.md b/wiki/Bootstrap-Scripts-Guide.md index 8aa8199..6541fc5 100644 --- a/wiki/Bootstrap-Scripts-Guide.md +++ b/wiki/Bootstrap-Scripts-Guide.md @@ -24,9 +24,6 @@ Run these first, in any order. They set up the foundation your agent needs. ### BOOTSTRAP-SECURITY.md — Security & Budget Setup Enables GuardDuty, Security Hub, Inspector, and Access Analyzer monitoring. Sets up AWS Budgets alerts to catch cost surprises. Creates security-focused cron jobs for ongoing monitoring. -### BOOTSTRAP-SKILLS.md — AWS Skills Library -Installs the core AWS infrastructure skills that teach Loki how to provision and manage AWS resources following best practices. Covers CDK, CloudFormation, Lambda, API Gateway, DynamoDB, S3, ECS, and more. - ### BOOTSTRAP-MCPORTER.md — MCP Server Tooling Sets up MCPorter for managing MCP (Model Context Protocol) servers. Configures the AWS MCP servers for documentation search, API access, and CloudFormation schema lookups. @@ -67,6 +64,9 @@ Adds a GitHub Action that runs Claude Code for automatic code review on PRs and ### OPTIMIZE-TOO-LARGE-CONTEXT.md — Context Optimization Tips for reducing system prompt size when hitting context limits. Covers workspace file pruning, memory consolidation, and skill management. +### BOOTSTRAP-SKILLS.md — Skills Library (Manual / Recovery) +The `openclaw` pack pre-installs the loki-skills library automatically during EC2 bootstrap, so this is usually a no-op. Run it manually only as a recovery path — `git` was missing on first boot, the clone failed, the existing skills checkout has a different origin, or you're on a non-openclaw pack that doesn't auto-install yet (hermes, nemoclaw, pi, ironclaw, kiro-cli, codex-cli, roundhouse, claude-code). + ## Telegram Bootstraps Set up Telegram as your chat interface with Loki.