SkillsAdd

mindfold-ai/trellis

trellis-start

Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/.

First seen May 9, 2026

Installation

$ npx skills add mindfold-ai/trellis --skill trellis-start
View on skills.sh ↗ GitHub repository ↗

Summary

  • 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

agent-browser Shared topics
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Shared topics
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Shared topics
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Shared topics
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-hosted-copilot-sdk Shared topics
microsoft/azure-skills 440.4K installs
azure-enterprise-infra-planner Shared topics
microsoft/azure-skills

Architect and provision enterprise Azure infrastructure from workload descriptions. For cloud a…

402.8K installs

Also in this package

Other skills from mindfold-ai/trellis · top by installs.

npx skills add mindfold-ai/trellis
trellis-meta 383 trellis-brainstorm 144 trellis-finish-work 128 trellis-check 125 trellis-continue 122 trellis-before-dev 117 trellis-update-spec 114 trellis-break-loop 113 python-design 104 contribute 99

Browse all from mindfold-ai/trellis

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 14.5K
License LICENSE
Default branch main
Open issues 45
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,832 B
  • docs SUMMARY.md 367 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 113 installs

SKILL.md

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.

python3 ./.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.

python3 ./.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.

python3 ./.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:

``bash python3 ./.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.