mcpbeat Sign in

Trellis Before Dev Agent Skill

by fy-agent

Discovers and injects project-specific coding guidelines from .trellis/spec/ before implementation begins. Reads spec indexes, pre-development checklists, and shared thinking guides for the target package. Use when starting a new coding task, before writing any code, switching to a different package, or needing to refresh project conventions and standards.

463 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
142
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/fy-agent/fyagent --skill trellis-before-dev

The instruction itself

as written by the author

Read the relevant development guidelines before starting your task.

Execute these steps:

  • Read current task artifacts:
  • prd.md for requirements and acceptance criteria
  • design.md if present for technical design
  • implement.md if present for execution order and validation plan
  • Discover packages and their spec layers:
   python ./.trellis/scripts/get_context.py --mode packages
  • Identify which specs apply to your task based on:
  • Which package you're modifying (e.g., cli/, docs-site/)
  • What type of work (backend, frontend, unit-test, docs, etc.)
  • Any spec/research paths referenced by the task artifacts
  • Read the spec index for each relevant module:
   cat .trellis/spec/<package>/<layer>/index.md

Follow the "Pre-Development Checklist" section in the index.

  • Read the specific guideline files listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., error-handling.md, conventions.md, mock-strategies.md). Read those files to understand the coding standards and patterns.
  • Always read shared guides:
   cat .trellis/spec/guides/index.md
  • Understand the coding standards and patterns you need to follow, then proceed with your development plan.

This step is mandatory before writing any code.

How to use it

Copy the folder

Take fy-agent/trellis-before-dev from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.