Agent skill

Start Here

by fl-sean03 in fl-sean03/OpenSDL

Establish or resume an OpenSDL laboratory through a normal agent conversation.

Apache-2.0Auto-check passedAgent Workflows

Install Start Here

skills CLI
$ npx skills add fl-sean03/OpenSDL --skill start-here -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fl-sean03/OpenSDL start-here --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fl-sean03/OpenSDL.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/start-here .claude/skills/start-here && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
start-here
GitHub stars
107
Token cost
~956 tokens
SKILL.md length
475 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

Establish or resume an OpenSDL laboratory through a normal agent conversation.

  • Works in 11 steps: Read the nearest AGENTS.md. Inspect the… → Determine whether the user is in this… → When a separate lab repository is… → …
  • A user says start here
  • SKILL.md covers Inputs, Procedure, Completion and Stop conditions
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Start Here is an agent skill from fl-sean03/OpenSDL. Establish or resume an OpenSDL laboratory through a normal agent conversation. Use when a user says start here, set up or configure my lab, plan a new lab or cell, describe existing equipment, continue a lab build, or turn a laboratory idea into a simulator-first implementation plan.

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Planning. The repository describes itself as: A modular Python foundation for reproducible computational and autonomous laboratories. Alpha; the reference profile is simulator-only. The licence is Apache-2.0.

When your agent uses it

  • A user says start here
  • Configure my lab
  • Describe existing equipment
  • Continue a lab build

Example prompts

  • “/start-here”

Workflow steps

11 steps, taken from the first numbered list in SKILL.md.

  1. Read the nearest AGENTS.md. Inspect the worktree, branch, recent commits, and current directory
  2. Determine whether the user is in this framework repository, a generated laboratory repository,
  3. When a separate lab repository is needed, collect its name, owner, and destination. Use
  4. In a lab repository, read docs/lab/context.md, inventory.md, setup-plan.md, and
  5. Classify the setup as existing, greenfield, or hybrid. Identify the first outcome before trying
  6. Update the shared lab files with confirmed facts, evidence, assumptions, unknowns, constraints,
  7. Track inventory evidence, integration, and visual-twin state separately. An inventory entry is
  8. Map the first workflow to resources, typed capabilities, simulators, manual steps, data, tests,
  9. Update executable manifests or workflows only from confirmed information and supported
  10. Record any custom 3D request in the lab setup plan with its purpose, source evidence,
  11. Hand the next task to create-lab, orient-lab, design-lab, add-capability, add-adapter,

What it can do on your machine

Read from SKILL.md and the folder at commit 43f4988. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Start Here loads about 956 tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 475 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~956

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from fl-sean03/OpenSDL at commit 43f4988, republished under its Apache-2.0 licence (© fl-sean03). 475 words, ~956 tokens.

Download SKILL.mdSave it as .claude/skills/start-here/SKILL.md (or your agent's skills folder).
name
start-here
description
Establish or resume an OpenSDL laboratory through a normal agent conversation. Use when a user says start here, set up or configure my lab, plan a new lab or cell, describe existing equipment, continue a lab build, or turn a laboratory idea into a simulator-first implementation plan.

Start or resume a laboratory

Inputs

  • intended laboratory outcome or first useful workflow
  • existing, planned, or hybrid setup
  • repository or proposed destination
  • known equipment, compute, manual work, samples, data, and locations
  • relevant constraints, hazards, and available evidence

Begin with partial input. Ask for only the highest-value missing information.

Procedure

  1. Read the nearest AGENTS.md. Inspect the worktree, branch, recent commits, and current directory before changing files.
  2. Determine whether the user is in this framework repository, a generated laboratory repository, or an uninitialized destination.
  3. When a separate lab repository is needed, collect its name, owner, and destination. Use create-lab only after the destination is confirmed and safe.
  4. In a lab repository, read docs/lab/context.md, inventory.md, setup-plan.md, and decisions.md when present. Then read opensdl.yaml and only the workflows needed for the task.
  5. Classify the setup as existing, greenfield, or hybrid. Identify the first outcome before trying to inventory the entire laboratory.
  6. Update the shared lab files with confirmed facts, evidence, assumptions, unknowns, constraints, and decisions. Keep the product-wide work list in docs/development/backlog.md.
  7. Track inventory evidence, integration, and visual-twin state separately. An inventory entry is not authority to execute equipment.
  8. Map the first workflow to resources, typed capabilities, simulators, manual steps, data, tests, and gaps. Prefer one complete simulation path over a broad incomplete configuration.
  9. Update executable manifests or workflows only from confirmed information and supported contracts. Run opensdl validate for any executable file changed.
  10. Record any custom 3D request in the lab setup plan with its purpose, source evidence, dimensions, and target workflow. An agent can build the tailored Blender scene directly in the laboratory repository. OpenSDL currently has no dedicated digital-twin command and intentionally has no model catalog.
  11. Hand the next task to create-lab, orient-lab, design-lab, add-capability, add-adapter, develop-workflow, add-domain-pack, or debug-run as appropriate. Use design-lab when the open question is physical or interface design rather than OpenSDL configuration.
Show full SKILL.md (158 more words)Show less

Do not run doctor, capability listing, inspection, or event queries merely for onboarding. They read without writing and will not create a store that is not there, but they report operational evidence rather than declared configuration, which is a different question from setting a laboratory up. Never pass doctor --reconcile during onboarding: it releases the leases of running runs and records their interrupted tasks as failed or as intervention_required depending on what each capability declared, and nothing clears intervention_required.

Completion

The repository contains enough confirmed shared context for a fresh agent to continue. The first workflow has a capability and gap map. Any executable changes validate, and the next skill or future dependency is explicit.

Stop conditions

Stop before mutation when repository ownership or the destination is unclear. Stop when sources conflict, secrets or unintended facility details would enter Git, or a required typed operation is missing. Do not commission equipment or perform physical work through this skill.

© fl-sean03, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/start-here of fl-sean03/OpenSDL.

Open the folder on GitHubat commit 43f4988

Compare with similar skills

Start Here next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Start Here compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Start Here this skillfl-sean03/OpenSDL107—~956Automated safety check: PassApache-2.0
Executing Plans Inlineobra/superpowers296k2 repos~5.1kAutomated safety check: PassMIT
Interview Meaddyosmani/agent-skills103k6 repos~3.8kAutomated safety check: PassMIT
OpenSpec Guided OnboardingFission-AI/OpenSpec71k1 repos~4.5kAutomated safety check: PassMIT
Writing Plansgeeksblabla/stateofdev.ma16357 repos~661Automated safety check: PassNone
Subagent Driven DevelopmentAsvarox/allkaraoke26138 repos~1.2kAutomated safety check: PassNone

Similar skills

  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    296k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Interview Me

    addyosmani/agent-skills

    Asks one question at a time, each with a best guess attached, until the agent is about 95 percent sure what you really want, before any plan, spec or code.

    103k GitHub starsUsed in 6 repos~3.8k tokens
    Agent WorkflowsAuto-check passed
  • OpenSpec Guided Onboarding

    Fission-AI/OpenSpec

    Walks you through a complete OpenSpec workflow cycle with narration while doing real work in your codebase.

    71k GitHub starsUsed in 1 repo~4.5k tokens
    Agent WorkflowsAuto-check passed
  • Writing Plans

    geeksblabla/stateofdev.ma

    A skill your agent uses when design is complete and you need detailed implementation tasks for engineers with zero codebase context - creates comprehensive implementation plans with exact file…

    163 GitHub starsUsed in 57 repos~661 tokens
    Agent WorkflowsAuto-check passed
  • Subagent Driven Development

    Asvarox/allkaraoke

    A skill your agent uses when executing implementation plans with independent tasks in the current session

    261 GitHub starsUsed in 38 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Planning With Files

    jd-opensource/JoySafeter

    Implements Manus-style file-based planning for complex tasks.

    313 GitHub starsUsed in 19 repos~1.8k tokens
    Agent WorkflowsAuto-check: notes

More from fl-sean03/OpenSDL

All 11 skills in this repo
  • Author Skill

    fl-sean03/OpenSDL

    Create, revise, split, or remove an OpenSDL repository skill.

    107 GitHub stars~440 tokensUpdated 4 days ago
    Auto-check passed
  • Create Lab

    fl-sean03/OpenSDL

    Create a simulator-first organization laboratory scaffold with policy and validation.

    107 GitHub stars~441 tokensUpdated 4 days ago
    Auto-check passed
  • Debug Run

    fl-sean03/OpenSDL

    Diagnose a failed OpenSDL run, reproduce it in simulation, and validate the smallest correct fix.

    107 GitHub stars~438 tokensUpdated 4 days ago
    Auto-check passed
  • Design Lab

    fl-sean03/OpenSDL

    Scope the physical and interface design of a laboratory before configuring it.

    107 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Develop Workflow

    fl-sean03/OpenSDL

    Design, change, validate, and test an OpenSDL workflow through a simulation manifest.

    107 GitHub stars~462 tokensUpdated 4 days ago
    Auto-check passed
  • Orient Lab

    fl-sean03/OpenSDL

    Inspect the current OpenSDL repository and declared laboratory state.

    107 GitHub stars~534 tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about Start Here

What does Start Here do?

Establish or resume an OpenSDL laboratory through a normal agent conversation. Start Here is an agent skill from fl-sean03/OpenSDL. Establish or resume an OpenSDL laboratory through a normal agent conversation.

When should I use Start Here?

Start Here fits situations like: A user says start here; configure my lab; describe existing equipment; continue a lab build.

How do I install Start Here in Claude Code?

Run `npx skills add fl-sean03/OpenSDL --skill start-here -a claude-code`. Or copy the skill folder (.agents/skills/start-here in fl-sean03/OpenSDL) into .claude/skills/start-here in your project. Claude Code loads it when a task matches its description.

How do I install Start Here in Codex?

Run `npx skills add fl-sean03/OpenSDL --skill start-here -a codex`. Or copy the skill folder (.agents/skills/start-here in fl-sean03/OpenSDL) into .agents/skills/start-here in your project. Codex loads it when a task matches its description.

Can I use Start Here in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fl-sean03/OpenSDL --skill start-here -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/start-here, .gemini/skills/start-here, .github/skills/start-here and .opencode/skills/start-here in your project.

What does Start Here need to run?

SKILL.md names no scripts, command-line tools or credentials: Start Here is instructions for the agent only.

Does Start Here access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Start Here safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Start Here use?

Start Here is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Start Here use?

About 956 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Start Here?

Skills that share tags, products or a category with Start Here: Executing Plans Inline (obra/superpowers, 296k stars), Interview Me (addyosmani/agent-skills, 103k stars), OpenSpec Guided Onboarding (Fission-AI/OpenSpec, 71k stars) and Writing Plans (geeksblabla/stateofdev.ma, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Start Here?

fl-sean03 (a GitHub user) maintains it in fl-sean03/OpenSDL, which has 107 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 4, 2026.

Source: fl-sean03/OpenSDL on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.