# Developing Tessl Skills

> Runs the complete local development lifecycle for a Tessl skill by optimizing SKILL.md content using `tessl skill review --optimize`, incrementing the version in tile.json following semantic versioning, linting with `tessl skill lint`, and staging changes for a pull request. Use when preparing a Tessl skill for pull request or publication, when a SKILL.md or tile.json needs to be reviewed, versio…

- **Type:** Skill
- **Install:** `agentstack add skill-nagaakihoshi-skills-developing-tessl-skills`
- **Verified:** Pending review
- **Seller:** [nagaakihoshi](https://agentstack.voostack.com/s/nagaakihoshi)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nagaakihoshi](https://github.com/nagaakihoshi)
- **Source:** https://github.com/nagaakihoshi/skills/tree/main/skills/developing-tessl-skills

## Install

```sh
agentstack add skill-nagaakihoshi-skills-developing-tessl-skills
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## Overview

This skill covers the complete local development lifecycle for a Tessl skill before opening a pull request. It ensures the skill is optimized, properly versioned, and validated.

## Prerequisites

- Tessl CLI installed: `curl -fsSL https://get.tessl.io | sh`
- Logged in: `tessl login`

## Steps

### 1. Identify the skill path

Confirm the skill directory (e.g., `skills//`) contains both `tile.json` and `SKILL.md`.

### 2. Optimize the skill

```bash
tessl skill review --optimize skills/
```

- Iterates up to 3 times, applying best-practice improvements automatically.
- Accept the proposed changes when prompted, or use `--yes` to auto-accept.
- Aim for a score of 70% or higher. If the score is still below threshold, re-run with `--max-iterations 10`.

### 3. Increment the version in tile.json

Open `skills//tile.json` and increment `version` following semantic versioning:

| Change type | Example |
|---|---|
| Bug fix or minor wording improvement | `0.1.0` → `0.1.1` |
| New capability, backward-compatible | `0.1.0` → `0.2.0` |
| Breaking change to skill behavior | `0.1.0` → `1.0.0` |

### 4. Validate

```bash
tessl skill lint skills/
```

Confirm the output shows the tile as valid before committing.

If lint fails: review the reported errors, fix the issues in `SKILL.md` or `tile.json`, then re-run `tessl skill lint` until it passes before proceeding.

### 5. Commit and open a PR

Stage all changes to `SKILL.md` and `tile.json`, commit, and open a pull request against `main`. CI will run `tessl skill lint` automatically on the PR.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nagaakihoshi](https://github.com/nagaakihoshi)
- **Source:** [nagaakihoshi/skills](https://github.com/nagaakihoshi/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nagaakihoshi-skills-developing-tessl-skills
- Seller: https://agentstack.voostack.com/s/nagaakihoshi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.