Agent skill

Developing Smart Contracts

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

Solidity smart contract development guidelines for Lineth blockchain.

AGPL-3.0Auto-check passedBackend & APIs

Install Developing Smart Contracts

skills CLI
$ npx skills add LFDT-Lineth/lineth-monorepo --skill developing-smart-contracts -a claude-code

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

GitHub CLI
$ gh skill install LFDT-Lineth/lineth-monorepo developing-smart-contracts --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/.agents/skills/developing-smart-contracts .claude/skills/developing-smart-contracts && 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
developing-smart-contracts
GitHub stars
126
Token cost
~1.4k tokens
SKILL.md length
423 words
Files
10
Skills in repo
3
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Solidity smart contract development guidelines for Lineth blockchain.

  • Works in 7 steps: Gas Optimization (CRITICAL) → NatSpec Docstrings (HIGH) → File Layout (HIGH) → …
  • Refactoring Solidity contracts
  • SKILL.md covers When to Apply, Licenses, Solidity Pragma and Rule Categories by Priority, plus 4 more sections
  • Calls pnpm

What it does

Developing Smart Contracts is an agent skill from LFDT-Lineth/lineth-monorepo. Solidity smart contract development guidelines for Lineth blockchain. Use when writing, reviewing, or refactoring Solidity contracts, or when the user asks about Solidity best practices, contract structure, or NatSpec docstrings. Covers NatSpec documentation, naming conventions, file layout, and code style.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files (for example `metadata.json`, `rules/commands.md` and `rules/file-layout.md`).

It sits in Backend & APIs, covering Smart contracts and Technical documentation. It works with Solidity 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

  • Refactoring Solidity contracts
  • The user asks about Solidity best practices
  • Contract structure
  • NatSpec docstrings

Example prompts

  • “/developing-smart-contracts”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Gas Optimization (CRITICAL)
  2. NatSpec Docstrings (HIGH)
  3. File Layout (HIGH)
  4. Naming Conventions (HIGH)
  5. Imports (MEDIUM)
  6. Visibility (MEDIUM)
  7. General Rules (MEDIUM)

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:

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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

Developing Smart Contracts loads about 1.4k tokens when it runs. Until then it costs about 84 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
~84
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

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

Download SKILL.mdSave it as .claude/skills/developing-smart-contracts/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
developing-smart-contracts
description
Solidity smart contract development guidelines for Lineth blockchain. Use when writing, reviewing, or refactoring Solidity contracts, or when the user asks about Solidity best practices, contract structure, or NatSpec docstrings. Covers NatSpec documentation, naming conventions, file layout, and code style.
license
AGPL-3.0
metadata.author
linea
metadata.version
1.0.0

Lineth Smart Contract Development

Best practices for developing Solidity smart contracts on Lineth blockchain. Contains rules covering documentation, naming, structure, and code style.

Reference: Lineth Contract Style Guide

When to Apply

Reference these guidelines when:

  • Writing new Solidity contracts for Lineth
  • Reviewing smart contract code
  • Refactoring existing contracts
  • Adding NatSpec docstring documentation
  • Setting up contract file structure

Licenses

// SPDX-License-Identifier: Apache-2.0 OR MIT

Solidity Pragma

  • Contracts: 0.8.33 (exact)
  • Interfaces, abstract contracts, libraries: ^0.8.33 (caret)

Rule Categories by Priority

PriorityCategoryImpactRule File
1Gas optimizationCRITICALrules/gas-optimization.md
2NatSpec DocstringsHIGHrules/natspec.md
3File LayoutHIGHrules/file-layout.md
4NamingHIGHrules/naming-conventions.md
5ImportsMEDIUMrules/imports.md
6VisibilityMEDIUMrules/visibility.md
7General RulesMEDIUMrules/general-rules.md

Read individual rule files for detailed explanations and code examples (correct and incorrect).

Quick Reference

1. Gas Optimization (CRITICAL)

Gas efficiency is critical for Lineth contracts. Apply these rules unless there is a documented safety, audit, or readability reason to deviate.

solidity
// Correct: external + calldata, cache storage reads
function submit(bytes32[] calldata _proofs) external {
  uint256 current = fee;
  require(current != 0, FeeNotSet());
  _verify(_proofs, current);
}

// Incorrect: public + memory, repeated storage reads
function submit(bytes32[] memory _proofs) public {
  require(fee != 0, FeeNotSet());
  _verify(_proofs, fee);
}

See rules/gas-optimization.md for details.

2. NatSpec Docstrings (HIGH)

ALWAYS use NatSpec docstrings for all public/external items.

solidity
// Correct: complete NatSpec with @notice, @param (in signature order), @return
/**
 * @notice Sends a message to L2.
 * @param _to The recipient address on L2.
 * @param _fee The fee amount in wei.
 * @return messageHash The hash of the sent message.
 */
function sendMessage(address _to, uint256 _fee) external payable returns (bytes32 messageHash);

Every contract/interface NatSpec block must include @author Consensys Software Inc. and @custom:security-contact security-report@linea.build.

Consult rules/natspec.md for NatSpec docstring rules and examples

3. File Layout (HIGH)

Interface structure:

  1. Structs → 2. Enums → 3. Events → 4. Errors → 5. External Functions

Contract structure:

  1. Using statements → 2. Constants → 3. State variables → 4. Structs → 5. Enums → 6. Events → 7. Errors → 8. Modifiers → 9. Functions

See rules/file-layout.md for templates.

4. Naming Conventions (HIGH)

See rules/naming-conventions.md for symbol naming conventions.

5. Imports (MEDIUM)

Always use named imports. Always insert a blank line after imports.

solidity
// Correct: named imports with blank line before NatSpec/contract declaration
import { IMessageService } from "../interfaces/IMessageService.sol";
import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol";

/**
 * @title Brief description.
 * @author Consensys Software Inc.
 * @custom:security-contact security-report@linea.build
 */
contract MessageService is IMessageService, Ownable {

See rules/imports.md for details.

Show full SKILL.md (178 more words)Show less
6. Visibility (MEDIUM)

See rules/visibility.md for rules on applying visibility modifiers (internal, external, public, etc).

7. General Rules (MEDIUM)

See rules/general-rules.md for inheritance and general style rules

Development Workflow

Follow this sequence when writing or modifying Solidity contracts:

  1. Write/modify contract applying rules from the priority table above.
  2. Compile and fix errors:
    bash
    pnpm -F contracts run build
  3. Run linter and fix warnings:
    bash
    pnpm -F contracts run lint:fix
  4. Run tests to verify behavior:
    bash
    pnpm -F contracts run test
  5. Verify NatSpec coverage: confirm all public/external functions, events, and errors have complete docstrings with @notice, @param (in signature order), and @return.
  6. Review gas patterns: check for unnecessary memory copies, repeated storage reads, and missing batch limits.
  7. Commit after passing the checklist below.

Commit Checklist

Before making a commit, please verify:

  • Rules on licenses and Solidity pragma have been applied
  • All public items have NatSpec docstrings (@notice, @param, @return)
  • All rules in rules/*.md have been applied
  • Linting passes (pnpm -F contracts run lint:fix)

Commands

For commands for testing and linting, refer to rules/commands.md

© 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 9 other files in .agents/skills/developing-smart-contracts of LFDT-Lineth/lineth-monorepo.

  • SKILL.md
  • metadata.json
  • rules/commands.md
  • rules/file-layout.md
  • rules/gas-optimization.md
  • rules/general-rules.md
  • rules/imports.md
  • rules/naming-conventions.md
  • rules/natspec.md
  • rules/visibility.md

Open the folder on GitHubat commit 75baf30

Compare with similar skills

Developing Smart Contracts 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.

Developing Smart Contracts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Developing Smart Contracts this skillLFDT-Lineth/lineth-monorepo126—~1.4kAutomated safety check: PassAGPL-3.0
Ethskillsaustintgriffith/ethskills294—~1.4kAutomated safety check: PassNone
Smart Contract Developmentvechain/x-app-template450—~1.1kAutomated safety check: PassMIT
Smart Contract Guidelines Advisortrailofbits/skills7.4k—~2.2kAutomated safety check: PassCC-BY-SA-4.0
Foundry Reference Modelaviggiano/security144—~516Automated safety check: PassMIT
Smart Contract InteractionNethereum/Nethereum2.3k—~1.9kAutomated safety check: PassMIT

Similar skills

  • Ethskills

    austintgriffith/ethskills

    Ethereum development knowledge for AI agents — from idea to deployed dApp.

    294 GitHub stars~1.4k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Smart Contract Development

    vechain/x-app-template

    Solidity smart contract development on VeChainThor — Hardhat setup, ERC-20/721 patterns, upgradeable contracts, gas optimization, testing with Thor Solo, security auditing, and ABI codegen.

    450 GitHub stars~1.1k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Official

    Reviews a smart contract project against Trail of Bits development guidelines, covering documentation, architecture, upgradeability, implementation quality, dependencies and tests.

    7.4k GitHub stars~2.2k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Foundry Reference Model

    aviggiano/security

    Build a simple independent Solidity reference implementation for Foundry tests.

    144 GitHub stars~516 tokensUpdated 22 days ago
    Backend & APIsAuto-check passed
  • Smart Contract Interaction

    Nethereum/Nethereum

    Interact with Ethereum smart contracts using Nethereum typed DTOs.

    2.3k GitHub stars~1.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Solidity Development

    hiromaily/go-crypto-wallet

    Solidity smart contract development workflow. An agent skill from hiromaily/go-crypto-wallet.

    128 GitHub stars~826 tokensUpdated 5 mo ago
    Backend & APIsAuto-check: notes

More from LFDT-Lineth/lineth-monorepo

  • 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 today
    Auto-check passed
  • Lineth Quickstart

    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…

    126 GitHub stars~1k tokensUpdated today
    Auto-check: notes

Categories

Questions about Developing Smart Contracts

What does Developing Smart Contracts do?

Solidity smart contract development guidelines for Lineth blockchain. Developing Smart Contracts is an agent skill from LFDT-Lineth/lineth-monorepo. Solidity smart contract development guidelines for Lineth blockchain.

When should I use Developing Smart Contracts?

Developing Smart Contracts fits situations like: refactoring Solidity contracts; the user asks about Solidity best practices; contract structure; natSpec docstrings.

How do I install Developing Smart Contracts in Claude Code?

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

How do I install Developing Smart Contracts in Codex?

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

Can I use Developing Smart Contracts 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 developing-smart-contracts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/developing-smart-contracts, .gemini/skills/developing-smart-contracts, .github/skills/developing-smart-contracts and .opencode/skills/developing-smart-contracts in your project.

What does Developing Smart Contracts need to run?

Going by SKILL.md and its folder, Developing Smart Contracts needs the command-line tools its instructions call (pnpm).

Does Developing Smart Contracts 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 Developing Smart Contracts 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 Developing Smart Contracts use?

Developing Smart Contracts 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 Developing Smart Contracts use?

About 1.4k tokens (SKILL.md is roughly 5.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 Developing Smart Contracts?

Skills that share tags, products or a category with Developing Smart Contracts: Ethskills (austintgriffith/ethskills, 294 stars), Smart Contract Development (vechain/x-app-template, 450 stars), Smart Contract Guidelines Advisor (trailofbits/skills, 7.4k stars) and Foundry Reference Model (aviggiano/security, 144 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Developing Smart Contracts?

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.