mindfold-ai/trellis126 installs

trellis-start

Q: How do I install this agent skill?

Run npx skills add https://github.com/mindfold-ai/trellis --skill trellis-start.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

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.

How do I install this agent skill?

npx skills add https://github.com/mindfold-ai/trellis --skill trellis-start

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
The skill initializes a development session by reading local project files and executing internal scripts. The primary concern is the potential for indirect prompt injection from untrusted project documentation, though the operational scope is limited to the local environment.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues

What does this agent skill do?

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:

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.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/mindfold-ai/trellis/trellis-start">View trellis-start on skillZs</a>