setup

Validate the Python environment and generate daily.yaml via guided setup questions.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/kaneyxx/paper-wiki --skill setup-kaneyxx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/kaneyxx/paper-wiki/tree/main/skills/setup
Command: npx skills add https://github.com/kaneyxx/paper-wiki --skill setup-kaneyxx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interactive first-run onboarding wizard. Verifies paper-wiki's Python environment, walks the user through five questions to build their personal recipe (vault path, topics, S2 API key, auto-ingest preference), writes the config files, and surfaces optional MCP servers. Use when the user invokes /paper-wiki:setup, when no personal recipe exists yet at ~/.config/paper-wiki/recipes/, or when downstream paperwiki SKILLs report missing config.

Core Features & Use Cases

  • Verifies the Python environment and ensures the paper-wiki venv is ready.
  • Asks five questions to build the daily.yaml personal recipe and a secrets.env placeholder.
  • Writes the two files to ~/.config/paper-wiki/recipes/daily.yaml and ~/.config/paper-wiki/secrets.env.
  • Exposes optional MCP server surfaces to enable paperclip and related components.
  • Serves as the initial setup flow for downstream SKILLs to load proper config after install.

Quick Start

Run /paper-wiki:setup to begin the onboarding wizard and generate your daily.yaml.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up paper-wiki and generate a daily.yaml configuration file?

To set up paper-wiki, run the onboarding wizard to verify your Python venv, answer five configuration questions, and generate your daily.yaml file at ~/.config/paper-wiki/recipes/.

What happens during the paper-wiki onboarding process?

The paper-wiki onboarding process validates the Python environment using ensure-env.sh, prompts you for vault paths and topics, writes daily.yaml, and creates a secrets.env placeholder for API keys.

Do I need a Semantic Scholar API key to configure paper-wiki?

Yes, the setup wizard asks for your Semantic Scholar (S2) API key to generate a safe secrets.placeholder within the secrets.env file during the configuration process.

Why are downstream paper-wiki SKILLs reporting a missing config error?

Downstream SKILLs report missing config when the daily.yaml recipe does not exist at ~/.config/paper-wiki/recipes/, requiring you to run the setup wizard to restore proper configuration.

Can I use paper-wiki without a pre-configured Python virtual environment?

No, the setup wizard runs environment verification via ensure-env.sh to ensure the paper-wiki venv is ready before writing any configuration files or exposing optional MCP servers.

What is the best way to configure optional MCP servers for paper-wiki?

The best way to configure optional MCP servers is by completing the setup wizard, which exposes these server surfaces to enable paperclip and related components after writing your daily.yaml.