agentsclimarketplace

St init

Skill mumez/smalltalk-dev-plugin/skills/st-init

Smalltalk (Pharo/Squeak) development session initializer. Use when starting a new Smalltalk development session, when the Smalltalk image connection needs to be established or verified, when the user asks about the development workflow or available commands, when development environment setup is needed, or when Docker or local Pharo/Squeak installation is required.From its SKILL.md

Install
npx -y skills add mumez/smalltalk-dev-plugin --skill st-init

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 15 stars15 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

5.1 KB, as published. Nobody here has run it

Initialize Smalltalk Development Session

Start a Smalltalk (Pharo or Squeak) development session: verify project structure, confirm the Smalltalk image connection, and orient to the development workflow.

Initialization Sequence

1. Check Project Structure

if [ ! -f ".project" ] && [ ! -d "src" ]; then
  echo "No Smalltalk project structure detected"
fi
  • ✅ .project OR src/ found → continue
  • ⚠️ Neither found → recommend smalltalk-dev:st-setup-project skill

If no project exists, offer to create one:

⚠️  No Smalltalk project structure detected in current directory.

Use /st-setup-project MyProjectName to set up:
  • .project configuration file
  • src/ directory with package structure
  • BaselineOf class and Core/Tests packages

Would you like to run /st-setup-project now?
  • User says yes: Invoke smalltalk-dev:st-setup-project skill, then continue with steps 2–4.
  • User says no / continue anyway: Proceed directly to step 2 (load smalltalk-developer) without project setup. Note in the status report that project structure is missing.

2. Load smalltalk-developer Skill

Use the Skill tool to load smalltalk-dev:smalltalk-developer. This activates the full development workflow guidance.

3. Verify Smalltalk Image Connection

Run Smalltalk version via eval:

mcp__smalltalk-interop__eval: 'Smalltalk version'
  • ✅ Returns version string → connected, proceed
  • ❌ Fails or times out → follow Connection Setup below

4. Confirm Ready

Report status to user:

✅ Smalltalk image connected: Pharo X.Y (...) [or Squeak X.Y (...)]
✅ smalltalk-developer skill loaded
📋 Development workflow: Edit → Lint → Import → Test

Connection Setup

If the Smalltalk image is not connected, check Docker availability first:

docker --version

Docker Setup (Recommended, Pharo only)

Generate compose.yml in the project root:

services:
  sis-pharo:
    image: mumez/smalltalk-interop-docker
    ports:
      - "5900:5900"
      - "6901:6901"
      - "8086:8086"
    environment:
      SIS_PORT: 8086
    volumes:
      - /tmp:/root/screenshots
      - .:/root/repos

Then instruct the user:

docker compose up -d

Re-verify connection after startup.

Local Installation

If Docker is not available or not preferred, ask the user which Smalltalk dialect they use:

Pharo

1. Install Pharo:

mkdir pharo-stable
cd pharo-stable
curl https://get.pharo.org | bash

2. Load PharoSmalltalkInteropServer:

./pharo Pharo.image metacello install github://mumez/PharoSmalltalkInteropServer:main/src BaselineOfPharoSmalltalkInteropServer

3. Start Pharo (SisServer starts automatically):

./pharo-ui

Re-verify connection after Pharo is running.

Squeak

1. Install Squeak from squeak.org.

2. Load SqueakSmalltalkInteropServer — see SqueakSmalltalkInteropServer for installation instructions.

3. Start Squeak (SisServer starts automatically, or start it manually as below).

Re-verify connection after Squeak is running.

Manual Start (Smalltalk image already installed)

If Pharo/Squeak is installed but the server is not running, ask the user to execute in the image:

SisServer current start

Development Workflow Overview

The core cycle (full details in smalltalk-dev:smalltalk-developer):

Edit .st file
    ↓
Lint (/st-lint)
    ↓
Import package (absolute path)
    ↓
Run tests
    ↓
Pass? → Done  |  Fail? → Debug → Fix → Repeat

Available Skills and Commands

CommandPurpose
/st-import PackageName /abs/pathImport Tonel package to the Smalltalk image
/st-test TestClassRun SUnit tests
/st-eval codeExecute Smalltalk snippet
/st-export PackageNameExport package from the Smalltalk image
/st-lint src/PackageNameValidate Smalltalk best practices

Troubleshooting

ProblemSolution
Connection timeoutCheck if the Smalltalk image is running
Server not startedRun SisServer current start in the Smalltalk image
Port mismatchCheck SIS_PORT env var (default: 8086)
MCP issuesVerify smalltalk-interop-mcp-server is installed
Docker path issuesCheck volume mounts in compose.yml

Related Skills

  • smalltalk-dev:st-setup-project — Create project structure if missing
  • smalltalk-dev:smalltalk-developer — Full development workflow
  • smalltalk-dev:smalltalk-debugger — Debug test failures and errors

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 0 of the 12 instructions most project setup skills give

Counted across 1,553 of the 3,091 authors here whose files we hold, read 2026-09-06

  • Write the configuration filein 36 of 1553
  • Create the directory structurein 35 of 1553, across 33 files
  • Verify the setupin 31 of 1553, across 28 files
  • Run the setup scriptin 30 of 1553, across 29 files
  • Pre-determine the required sample sizein 29 of 1553, across 12 files
  • Check if the configuration already existsin 29 of 1553
  • Document every testin 26 of 1553, across 10 files
  • Start with a hypothesisin 26 of 1553, across 11 files
  • Ask one question at a timein 22 of 1553
  • Test a single variable per testin 21 of 1553, across 9 files
  • Read product marketing context before asking questionsin 19 of 1553, across 8 files
  • Do not peek and stop earlyin 18 of 1553, across 7 files

Said here and by no other author read

  • Confirm Smalltalk image connection
  • Load smalltalk-developer skill
  • Generate compose.yml
  • Run docker compose up

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once.

Keep looking

Skills are one crate of 612,213. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.