Agent skill

Lineth Quickstart

by LFDT-Lineth in LFDT-Lineth/lineth-monorepo

Operating manual for the Lineth Stack quickstart — the Docker-Compose dev/demo stack at docs/getting-started/lineth-stack in the lineth-monorepo that boots a local Linea/Lineth L2 with Sepolia or…

AGPL-3.0Auto-check: notesDevelopment

Install Lineth Quickstart

skills CLI
$ npx skills add LFDT-Lineth/lineth-monorepo --skill lineth-quickstart -a claude-code

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

GitHub CLI
$ gh skill install LFDT-Lineth/lineth-monorepo lineth-quickstart --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/LFDT-Lineth/lineth-monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/getting-started/lineth-stack/.agents/skills/lineth-quickstart .claude/skills/lineth-quickstart && 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
lineth-quickstart
GitHub stars
126
Token cost
~1k tokens
SKILL.md length
423 words
Files
4
Skills in repo
3
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Operating manual for the Lineth Stack quickstart — the Docker-Compose dev/demo stack at docs/getting-started/lineth-stack in the lineth-monorepo that boots a local Linea/Lineth L2 with Sepolia or…

  • You are working inside the lineth-stack quickstart and need to boot
  • SKILL.md covers Start here, Two things agents most often…, When something fails and When you change scripts or…
  • Calls git
  • Choose between local and Sepolia L1 mode

What it does

Lineth Quickstart is an agent skill from LFDT-Lineth/lineth-monorepo. Operating manual for the Lineth Stack quickstart — the Docker-Compose dev/demo stack at docs/getting-started/lineth-stack in the lineth-monorepo that boots a local Linea/Lineth L2 with Sepolia or local L1 finality. Use whenever you are working inside the lineth-stack quickstart and need to boot or run the stack, choose between local and Sepolia L1 mode, get past the Sepolia deployer-funding step, read the finality/success signals, run traffic or bridge smoke tests, reset it, or debug a failing boot (L1 RPC…

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `metadata.json`, `rules/debugging.md` and `rules/making-changes.md`).

It sits in Development, covering Monorepo tooling, Containers and QA and bug reports. It works with Docker and Ethereum. The repository describes itself as: The principal Lineth repository. Lineth is an enterprise-grade EVM layer 2 framework for developing public, permissioned or private networks. Its modular and versatile design… The licence is AGPL-3.0.

When your agent uses it

  • You are working inside the lineth-stack quickstart and need to boot
  • Choose between local and Sepolia L1 mode
  • Get past the Sepolia deployer-funding step
  • Read the finality/success signals

Example prompts

  • “start the stack”
  • “run the quickstart”
  • “boot lineth locally”
  • “/lineth-quickstart”

Requirements

  • Docker

What it can do on your machine

Read from SKILL.md and the folder at commit 75baf30. 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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Lineth Quickstart loads about 1k tokens when it runs. Until then it costs about 240 tokens; SKILL.md has 423 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:68
    blocked. Never commit `.env`, `artifacts/`, or any real secret.

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 LFDT-Lineth/lineth-monorepo at commit 75baf30, republished under its AGPL-3.0 licence (© LFDT-Lineth). 423 words, ~1,000 tokens.

Download SKILL.mdSave it as .claude/skills/lineth-quickstart/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
lineth-quickstart
description
Operating manual for the Lineth Stack quickstart — the Docker-Compose dev/demo stack at docs/getting-started/lineth-stack in the lineth-monorepo that boots a local Linea/Lineth L2 with Sepolia or local L1 finality. Use whenever you are working inside the lineth-stack quickstart and need to boot or run the stack, choose between local and Sepolia L1 mode, get past the Sepolia deployer-funding step, read the finality/success signals, run traffic or bridge smoke tests, reset it, or debug a failing boot (L1 RPC unreachable, deploy gas too low, unfunded deployer, port collision, prover out-of-memory, address mismatch, finality not advancing). Trigger even on casual asks — "start the stack", "run the quickstart", "boot lineth locally", "my deploy keeps failing", "finality isn't happening", "reset the quickstart". When editing this package's scripts or docs, also read rules/making-changes.md so commits pass the repo's lint and DCO gates.
license
AGPL-3.0
metadata.author
linea
metadata.version
1.0.0

Lineth Stack quickstart — agent skill

This skill helps you operate the Lineth Stack quickstart: a Docker-Compose dev/demo stack that boots a local Linea/Lineth L2 settled by either Sepolia (default, real public L1) or a self-contained local Besu+Teku L1. It is a dev/demo tool, not a production deployment.

The skill does not restate the boot procedure — that has one source of truth in the package, and duplicating it here would let the two drift apart. Your job is to route to that source, then layer on the failure triage and change/commit rules the skill bundles.

Start here

Run everything from docs/getting-started/lineth-stack/ (find it with git rev-parse --show-toplevel then cd in). Then read these two files before acting — they are the procedure, and if anything here ever disagrees with them, they win:

  • AGENTS.md — the canonical operating runbook: preflight, L1-mode choice, the boot commands, the Sepolia funding stop, success signals, reset, and guardrails. Follow it step by step.
  • README.md — the operator guide it draws on: endpoints, gas caps, prover modes, full troubleshooting.

Don't work from memory or from this file's summary — the stack is nonce/order-sensitive and artifact-driven, so a 60-second read of the current AGENTS.md prevents a failed boot.

Two things agents most often get wrong

These are the classic false steps; AGENTS.md has the detail, but keep them front of mind:

  • The Sepolia first-boot "exit" is expected, not an error. First Sepolia boot generates the deployer keystore, prints the address + funding amount, and stops before any container starts. You cannot fund it — surface the address to the human, then rerun the same command. For unattended runs, choose --l1-mode local instead, which needs no funding.
  • Success means finality, not a blob. Report success only on an observed finalizeBlocks and an advancing rollup currentL2BlockNumber. Submit Blobs only publishes data — it is not finalization.
Show full SKILL.md (124 more words)Show less

When something fails

Read rules/debugging.md — it has a symptom → cause → fix table (RPC unreachable, gas too low, unfunded deployer, port collision, prover OOM, address mismatch, finality not advancing), the logs-first diagnostics, and timing expectations so "slow" isn't mistaken for "broken". Hard STOP conditions that need a human: an unfunded Sepolia deployer and repeated Sepolia gas/RPC failures.

When you change scripts or docs in this package

Read rules/making-changes.md — read-before-change, the validation gate (./scripts/check-quickstart-static.sh plus a real boot for boot-path changes), and the repo's commit rules that reject otherwise-fine commits: scope must be from the allowed list (use misc; lineth-stack is rejected), git commit -s for DCO, and a GitHub noreply author email or the push is blocked. Never commit .env, artifacts/, or any real secret.

© LFDT-Lineth, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in docs/getting-started/lineth-stack/.agents/skills/lineth-quickstart of LFDT-Lineth/lineth-monorepo.

  • SKILL.md
  • metadata.json
  • rules/debugging.md
  • rules/making-changes.md

Open the folder on GitHubat commit 75baf30

Compare with similar skills

Lineth Quickstart 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.

Lineth Quickstart compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Lineth Quickstart this skillLFDT-Lineth/lineth-monorepo126—~1kAutomated safety check: NotesAGPL-3.0
Local Project Runtimepenwyp/ClaudePreference136—~1.1kAutomated safety check: NotesMIT
Shopsys Commandsshopsys/shopsys350—~291Automated safety check: PassCustom licence
DeerFlow Smoke Testbytedance/deer-flow83k—~2.5kAutomated safety check: NotesMIT
PgjevrealZachi/pg-jev1k—~2.9kAutomated safety check: PassCustom licence
Running TestsNangoHQ/nango13k—~876Automated safety check: PassCustom licence

Similar skills

  • Local Project Runtime

    penwyp/ClaudePreference

    Diagnose and stabilize local project setup after clone or checkout.

    136 GitHub stars~1.1k tokensUpdated 4 mo ago
    DevelopmentAuto-check: notes
  • Shopsys Commands

    shopsys/shopsys

    The command catalog for the Shopsys monorepo — how to build, run, test, check code, access the database, and sync the GraphQL schema, including the macOS Mutagen workflow and per-package test configs.

    350 GitHub stars~291 tokensUpdated today
    DevelopmentAuto-check passed
  • DeerFlow Smoke Test

    bytedance/deer-flow

    Walks through an end-to-end smoke test of a DeerFlow deployment: pull the latest code, deploy with Docker or locally, verify services, run health checks and write a report.

    83k GitHub stars~2.5k tokensUpdated today
    Testing & QAAuto-check: notes
  • Pgjev

    realZachi/pg-jev

    Install, configure, query and explain pgjev (the jev PostgreSQL extension that filters, ranks and classifies rows with plain-language conditions via TypeSafe's Jev model).

    1k GitHub stars~2.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Running Tests

    NangoHQ/nango

    A skill your agent uses when running tests in the Nango monorepo - knows unit vs integration configs, vitest commands, Docker setup, and common test patterns

    13k GitHub stars~876 tokensUpdated today
    Testing & QAAuto-check passed
  • Lvc Run App

    open-edge-platform/edge-ai-suites

    Run, start, or smoke-test the Live Video Captioning app (Docker Compose stack with dashboard on :4173).

    140 GitHub stars~796 tokensUpdated yesterday
    Testing & QAAuto-check passed

More from LFDT-Lineth/lineth-monorepo

  • Developing Smart Contracts

    LFDT-Lineth/lineth-monorepo

    Solidity smart contract development guidelines for Lineth blockchain.

    126 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Squash Bugbot

    LFDT-Lineth/lineth-monorepo

    Triage unresolved bot review comments on a GitHub PR. An agent skill from LFDT-Lineth/lineth-monorepo.

    126 GitHub stars~3.3k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Lineth Quickstart

What does Lineth Quickstart do?

Operating manual for the Lineth Stack quickstart — the Docker-Compose dev/demo stack at docs/getting-started/lineth-stack in the lineth-monorepo that boots a local Linea/Lineth L2 with Sepolia or…. Lineth Quickstart is an agent skill from LFDT-Lineth/lineth-monorepo. Operating manual for the Lineth Stack quickstart — the Docker-Compose dev/demo stack at docs/getting-started/lineth-stack in the lineth-monorepo that boots a local Linea/Lineth L2 with Sepolia or local L1 finality.

When should I use Lineth Quickstart?

Lineth Quickstart fits situations like: you are working inside the lineth-stack quickstart and need to boot; choose between local and Sepolia L1 mode; get past the Sepolia deployer-funding step; read the finality/success signals.

How do I install Lineth Quickstart in Claude Code?

Run `npx skills add LFDT-Lineth/lineth-monorepo --skill lineth-quickstart -a claude-code`. Or copy the skill folder (docs/getting-started/lineth-stack/.agents/skills/lineth-quickstart in LFDT-Lineth/lineth-monorepo) into .claude/skills/lineth-quickstart in your project. Claude Code loads it when a task matches its description.

How do I install Lineth Quickstart in Codex?

Run `npx skills add LFDT-Lineth/lineth-monorepo --skill lineth-quickstart -a codex`. Or copy the skill folder (docs/getting-started/lineth-stack/.agents/skills/lineth-quickstart in LFDT-Lineth/lineth-monorepo) into .agents/skills/lineth-quickstart in your project. Codex loads it when a task matches its description.

Can I use Lineth Quickstart 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 LFDT-Lineth/lineth-monorepo --skill lineth-quickstart -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lineth-quickstart, .gemini/skills/lineth-quickstart, .github/skills/lineth-quickstart and .opencode/skills/lineth-quickstart in your project.

What does Lineth Quickstart need to run?

Going by SKILL.md and its folder, Lineth Quickstart needs the command-line tools its instructions call (git). Our summary lists: Docker.

Does Lineth Quickstart access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Lineth Quickstart safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Lineth Quickstart use?

Lineth Quickstart is published under the AGPL-3.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Lineth Quickstart use?

About 1k tokens (SKILL.md is roughly 4k 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 Lineth Quickstart?

Skills that share tags, products or a category with Lineth Quickstart: Local Project Runtime (penwyp/ClaudePreference, 136 stars), Shopsys Commands (shopsys/shopsys, 350 stars), DeerFlow Smoke Test (bytedance/deer-flow, 83k stars) and Pgjev (realZachi/pg-jev, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lineth Quickstart?

LFDT-Lineth (a GitHub organization) maintains it in LFDT-Lineth/lineth-monorepo, which has 126 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 6, 2026.

Source: LFDT-Lineth/lineth-monorepo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.