Skip to content

feat: one-line natural language install via curl + instruction.md #35

@lbfsc

Description

@lbfsc

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)
    1. Follow the instructions inside instruction.md, which will guide the agent to:
    • 2.1 Install the skill — clone/copy the skill files into the correct location in the current project
    • 2.2 Auto-run an evaluation — automatically execute "write an evaluation report for the current project"
    • 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.

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request
No fields configured for Feature.

Projects

Status
Backlog

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions