feat: one-line natural language install via curl + instruction.md
- Dominant language
- Go
- Stars
- 894
- Forks
- 68
- Avg merge
- 1d 15h
- Merged PRs (30d)
- 38
Description
## 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:///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.
Contributor guide
Assessment
This issue has not been assessed yet.