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

Open
#35 0 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@lijunfeng722 is already working on this.

Since May 20, 2026.

Assessment

This issue has not been assessed yet.

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://<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.

Dominant language
Go
Stars
1.5k
Forks
134
Avg merge
1d 22h
Merged PRs (30d)
61

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from alibaba/skill-up

All issues in alibaba/skill-up

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.