## Problem / Motivation Currently, installing and trying out skill-up requires multiple manual steps: cloning the repo, reading the docs, understanding the skill structure, and figuring out how to run an evaluation. This friction makes it hard for new users to get started quickly. ## Proposed Solution Allow users to install and experience skill-up through a **single copy-paste command** that an AI agent (e.g. Claude, Cursor, etc.) can execute via natural language. The user simply pastes the following into their AI agent chat: ``` curl https://<host>/instruction.md | follow the instructions inside ``` The agent will: 1. **Download `instruction.md`** — fetch the file from the remote URL via `curl` (or equivalent HTTP request) 2. 2. **Follow the instructions inside `instruction.md`**, which will guide the agent to: 3. - **2.1 Install the skill** — clone/copy the skill files into the correct location in the current project 4. - **2.2 Auto-run an evaluation** — automatically execute "write an evaluation report for the current project" 5. - **2.3 Open the evaluation report** — open or display the generated report so the user can see the results immediately ## What `instruction.md` Should Contain `instruction.md` is a plain-text / Markdown file written as instructions for an AI agent. It should include: - Steps to install the skill (e.g. copy files, update config) - - A command/prompt to trigger the evaluation: e.g. _"Now run: help me write an evaluation for the current project"_ - - - A step to open the resulting report file in the editor or browser ## Why This Approach - **Zero friction onboarding**: users don't need to read any documentation upfront - - **Agent-native**: leverages the AI agent's ability to follow natural language instructions - - - **Self-contained**: the entire setup flow lives in one versioned Markdown file, easy to update - - - - **Works across agents**: any agent that can run `curl` and follow Markdown instructions can use this flow ## Alternatives Considered - A shell install script (`install.sh`): less readable, not natural language, harder for agents to reason about - - A README section: requires users to manually follow steps, not automated ## Additional Context This feature would dramatically lower the barrier to entry for skill-up and provide an instant "wow" moment for new users — they paste one line and immediately see a working evaluation report.