SkillAgentSearch skills...

trellis-start

Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/. Classifies incoming tasks and routes to brainstorm, direct edit, or task workflow

Install / Use

npx skills add fy-agent/fyagent --skill trellis-start

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

85/100

Category

Automation

Supported Platforms

Universal

Our assessment of trellis-start

trellis-start scores 85/100 on our quality scale, 1967th of 2,780 Automation skills we index.

Its SKILL.md is 2.8 KB long, split into 6 sections with 3 code examples: a solid amount of guidance for an agent.

With 1,181 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
16/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so trellis-start is actively maintained.
  • Our last check on 2026-11-05 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

trellis-start compared with similar skills

All 4 of these similar skills score higher than trellis-start; compare them before choosing.

SkillScoreStarsUpdatedFormat
trellis-start (this skill)by fy-agent851.2k55d agoSKILL.md
Agent-Reachby Panniantong100112.3k9d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server

Frequently asked questions

How do I install trellis-start?
Run npx skills add fy-agent/fyagent --skill trellis-start. The install tabs above show the steps for each supported agent.
Which AI agents does trellis-start work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is trellis-start safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is trellis-start still maintained?
The repository was last updated about 2 months ago, so trellis-start is actively maintained.

name: trellis-start description: "Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/. Classifies incoming tasks and routes to brainstorm, direct edit, or task workflow. Use when beginning a new coding session, resuming work, starting a new task, or re-establishing project context."

Start Session

Initialize a Trellis-managed development session. This platform has no session-start hook, so manually load the equivalent compact context by following these steps.


Step 1: Current state

Identity, git status, current task, active tasks, journal location.

python ./.trellis/scripts/get_context.py

If this output includes a line beginning Trellis update available:, copy the full line verbatim when summarizing session context. Do not shorten operational command hints.

Step 2: Workflow overview

Compact Phase Index, request triage rules, planning artifact contract, and the step-detail command.

python ./.trellis/scripts/get_context.py --mode phase

Full guide in .trellis/workflow.md (read on demand).

Step 3: Guideline indexes

Discover packages + spec layers, then read each relevant index file.

python ./.trellis/scripts/get_context.py --mode packages
cat .trellis/spec/guides/index.md
cat .trellis/spec/<package>/<layer>/index.md   # for each relevant layer

Index files list the specific guideline docs to read when you actually start coding.

Step 4: Decide next action

From Step 1 you know the current task and status. Check the task directory:

  • Active task status planning + no prd.md → Phase 1.1. Load the trellis-brainstorm skill.
  • Active task status planning + prd.md exists → stay in Phase 1. Lightweight tasks can be PRD-only; complex tasks need design.md + implement.md. Load the relevant Phase 1 step detail before task.py start.
  • Active task status in_progress → Phase 2 step 2.1. Load the step detail:
    python ./.trellis/scripts/get_context.py --mode phase --step 2.1 --platform codex
    
  • No active task → classify first. For simple conversation / small task, ask only whether this turn should create a Trellis task. For complex work, ask whether you may create a Trellis task and enter planning. If the user says no, skip Trellis for this session.

Skill routing (quick reference)

| User intent | Skill | |---|---| | New feature / unclear requirements | trellis-brainstorm | | About to write code | trellis-before-dev | | Done coding / quality check | trellis-check | | Stuck / fixed same bug multiple times | trellis-break-loop | | Learned something worth capturing | trellis-update-spec |

Full rules + anti-rationalization table in .trellis/workflow.md.

Related Skills

View on GitHub
GitHub Stars1.2k
CategoryAutomation
Updated1mo ago
Forks135

Languages

Rust

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium
trellis-start — Universal Skill: Install & Safety Check | SkillAgent