setup-workspace

Configures a PKM workspace by verifying seed files, building a user profile, and setting up Python environments.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill setup-workspace-hivgb1-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-workspace
Source: https://github.com/hivgb1-ai/do-better-workspace-v2/tree/main/.claude/skills/setup-workspace
Command: npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill setup-workspace-hivgb1-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, openpyxl, pymupdf4llm.

What problem does it solve? After cloning the Do Better Workspace repository, users face a fragmented onboarding process: filling in their CLAUDE.md profile, checking that template and wiki seed files exist, installing Python packages for data skills, and understanding which collection channels (KakaoTalk, SMS, email) work on their device combination. This Skill walks through the entire initial setup interactively in one guided session. ## Core Features & Use Cases - Seed Integrity Check: Verifies that templates, personal directories, wiki files, and registry YAML files exist, warning about missing pieces before they cause skill errors later. - Interactive Profile Setup: Asks four questions one at a time (name, role, interests, purpose) and updates only the profile section of CLAUDE.md without overwriting other content. - Python Environment Provisioning: Creates a .venv virtual environment and installs pandas, openpyxl, and pymupdf4llm for the csv-clean, excel-to-csv, and pdf-to-md skills. - Collection Channel Matrix: Detects computer OS and asks about phone OS and mail provider to advise which automatic capture channels (KakaoTalk, SMS, email) are viable. - Use Case: A non-developer clones the workspace for the first time, says "워크스페이스 세팅해줘", and completes profile creation, environment setup, and their first daily note in one conversation. ## Quick Start Tell the AI "set up my workspace" after cloning the repository to begin the guided initial configuration.

Frequently Asked Questions about setup-workspace

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

FAQPage Schema
How do I set up the Do Better Workspace after cloning?

Run the setup-workspace skill by saying "워크스페이스 세팅해줘" or "setup" in Claude Code from the workspace root. It interactively handles profile creation, seed file checks, Python environment setup, and your first daily note.

What Python packages does the workspace setup install?

The setup creates a .venv virtual environment and installs pandas, openpyxl, and pymupdf4llm. These packages power the csv-clean, excel-to-csv, and pdf-to-md data processing skills.

Can I skip the Python environment setup during workspace configuration?

Yes, the Python venv step is optional and recommended but not forced. You can decline it during setup and install the packages later by rerunning the skill or using pip directly.

Does setup-workspace overwrite my existing CLAUDE.md profile?

No, it only edits the profile section using partial edits and asks for confirmation before overwriting an already-filled profile. Other sections of CLAUDE.md remain untouched.

What happens if seed files are missing after cloning?

The skill lists all missing templates, directories, and registry files as warnings and asks whether to continue. It does not auto-restore them, so you should re-clone or copy missing files from the original repository.

Is the setup-workspace skill safe to run multiple times?

Yes, it is designed to be re-run safely. Already-configured items like an existing .venv or filled profile are detected and skipped automatically.