Vercel Composition Patterns
supabase/supabase
React composition patterns that scale. An agent skill from supabase/supabase.
Captures executable contracts and coding conventions into .trellis/spec/ documents.
$ npx skills add anjiemo/SunnyBeach --skill trellis-update-spec -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install anjiemo/SunnyBeach trellis-update-spec --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/anjiemo/SunnyBeach.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/trellis-update-spec .claude/skills/trellis-update-spec && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "trellis-update-spec" agent skill from https://github.com/anjiemo/SunnyBeach/tree/master/.agents/skills/trellis-update-spec into .claude/skills/trellis-update-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "trellis-update-spec", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/anjiemo/SunnyBeach/tree/master/.agents/skills/trellis-update-specType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add anjiemo/SunnyBeach --skill trellis-update-spec -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install anjiemo/SunnyBeach trellis-update-spec --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/anjiemo/SunnyBeach.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/trellis-update-spec .agents/skills/trellis-update-spec && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "trellis-update-spec" agent skill from https://github.com/anjiemo/SunnyBeach/tree/master/.agents/skills/trellis-update-spec into .agents/skills/trellis-update-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "trellis-update-spec", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add anjiemo/SunnyBeach --skill trellis-update-spec -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install anjiemo/SunnyBeach trellis-update-spec --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/anjiemo/SunnyBeach.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/trellis-update-spec .cursor/skills/trellis-update-spec && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "trellis-update-spec" agent skill from https://github.com/anjiemo/SunnyBeach/tree/master/.agents/skills/trellis-update-spec into .cursor/skills/trellis-update-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "trellis-update-spec", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/anjiemo/SunnyBeach.git --path .agents/skills/trellis-update-spec--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add anjiemo/SunnyBeach --skill trellis-update-spec -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install anjiemo/SunnyBeach trellis-update-spec --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/anjiemo/SunnyBeach.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/trellis-update-spec .gemini/skills/trellis-update-spec && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "trellis-update-spec" agent skill from https://github.com/anjiemo/SunnyBeach/tree/master/.agents/skills/trellis-update-spec into .gemini/skills/trellis-update-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "trellis-update-spec", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install anjiemo/SunnyBeach trellis-update-specInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add anjiemo/SunnyBeach --skill trellis-update-spec -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/anjiemo/SunnyBeach.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/trellis-update-spec .github/skills/trellis-update-spec && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "trellis-update-spec" agent skill from https://github.com/anjiemo/SunnyBeach/tree/master/.agents/skills/trellis-update-spec into .github/skills/trellis-update-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "trellis-update-spec", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add anjiemo/SunnyBeach --skill trellis-update-spec -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install anjiemo/SunnyBeach trellis-update-spec --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/anjiemo/SunnyBeach.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/trellis-update-spec .opencode/skills/trellis-update-spec && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "trellis-update-spec" agent skill from https://github.com/anjiemo/SunnyBeach/tree/master/.agents/skills/trellis-update-spec into .opencode/skills/trellis-update-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "trellis-update-spec", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
trellis-update-specCaptures executable contracts and coding conventions into .trellis/spec/ documents.
Trellis Update Spec is an agent skill from anjiemo/SunnyBeach. Captures executable contracts and coding conventions into .trellis/spec/ documents. Use when learning something valuable from debugging, implementing, or discussion that should be preserved for future sessions.
Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development. The repository describes itself as: 这是一款基于 Kotlin、MVVM 和 Jetpack 构建的【阳光沙滩】社区开源Android客户端。我们的使命是让编程学习更简单,欢迎贡献!. The licence is Apache-2.0.
5 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit ec2bf56. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown and bash).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Trellis Update Spec loads about 2.8k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 915 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from anjiemo/SunnyBeach at commit ec2bf56, republished under its Apache-2.0 licence (© anjiemo). 915 words, ~2,756 tokens.
.claude/skills/trellis-update-spec/SKILL.md (or your agent's skills folder).When you learn something valuable (from debugging, implementing, or discussion), use this to update the relevant code-spec documents.
Timing: After completing a task, fixing a bug, or discovering a new pattern
In this project, "spec" for implementation work means code-spec:
If the change touches infra or cross-layer contracts, code-spec depth is mandatory.
Apply code-spec depth when the change includes any of:
For triggered tasks, include all sections below:
| Trigger | Example | Target Spec |
|---|---|---|
| Implemented a feature | Added a new integration or module | Relevant spec file |
| Made a design decision | Chose extensibility pattern over simplicity | Relevant spec + "Design Decisions" section |
| Fixed a bug | Found a subtle issue with error handling | Relevant spec (e.g., error-handling docs) |
| Discovered a pattern | Found a better way to structure code | Relevant spec file |
| Hit a gotcha | Learned that X must be done before Y | Relevant spec + "Common Mistakes" section |
| Established a convention | Team agreed on naming pattern | Quality guidelines |
| New thinking trigger | "Don't forget to check X before doing Y" | guides/*.md (as a checklist item) |
Key Insight: Code-spec updates are NOT just for problems. Every feature implementation contains design decisions and contracts that future AI/developers need to execute safely.
.trellis/spec/
├── <layer>/ # Per-layer coding standards (e.g., backend/, frontend/, api/)
│ ├── index.md # Overview and links
│ └── *.md # Topic-specific guidelines
└── guides/ # Thinking checklists (NOT coding specs!)
├── index.md # Guide index
└── *.md # Topic-specific guides| Type | Location | Purpose | Content Style |
|---|---|---|---|
| Code-Spec | <layer>/*.md | Tell AI "how to implement safely" | Signatures, contracts, matrices, cases, test points |
| Guide | guides/*.md | Help AI "what to think about" | Checklists, questions, pointers to specs |
Decision Rule: Ask yourself:
guides/Example:
| Learning | Wrong Location | Correct Location |
|---|---|---|
| "Use API X not API Y for this task" | ❌ guides/ (too specific for a thinking guide) | ✅ Relevant spec file (concrete convention) |
| "Remember to check X when doing Y" | ❌ Spec file (too abstract for a spec) | ✅ guides/ (thinking checklist) |
Guides should be short checklists that point to specs, not duplicate the detailed rules.
Answer these questions:
| Type | Description | Action |
|---|---|---|
| Design Decision | Why we chose approach X over Y | Add to "Design Decisions" section |
| Project Convention | How we do X in this project | Add to relevant section with examples |
| New Pattern | A reusable approach discovered | Add to "Patterns" section |
| Forbidden Pattern | Something that causes problems | Add to "Anti-patterns" or "Don't" section |
| Common Mistake | Easy-to-make error | Add to "Common Mistakes" section |
| Convention | Agreed-upon standard | Add to relevant section |
| Gotcha | Non-obvious behavior | Add warning callout |
Before editing, read the current code-spec to:
cat .trellis/spec/<category>/<file>.mdFollow these principles:
If you added a new section or the code-spec status changed, update the category's index.md.
## Scenario: <name>
### 1. Scope / Trigger
- Trigger: <why this requires code-spec depth>
### 2. Signatures
- Backend command/API/DB signature(s)
### 3. Contracts
- Request fields (name, type, constraints)
- Response fields (name, type, constraints)
- Environment keys (required/optional)
### 4. Validation & Error Matrix
- <condition> -> <error>
### 5. Good/Base/Bad Cases
- Good: ...
- Base: ...
- Bad: ...
### 6. Tests Required
- Unit/Integration/E2E with assertion points
### 7. Wrong vs Correct
#### Wrong
...
#### Correct
...### Design Decision: [Decision Name]
**Context**: What problem were we solving?
**Options Considered**:
1. Option A - brief description
2. Option B - brief description
**Decision**: We chose Option X because...
**Example**:
\`\`\`typescript
// How it's implemented
code example
\`\`\`
**Extensibility**: How to extend this in the future...### Convention: [Convention Name]
**What**: Brief description of the convention.
**Why**: Why we do it this way in this project.
**Example**:
\`\`\`typescript
// How to follow this convention
code example
\`\`\`
**Related**: Links to related conventions or specs.### Pattern Name
**Problem**: What problem does this solve?
**Solution**: Brief description of the approach.
**Example**:
\`\`\`
// Good
code example
// Bad
code example
\`\`\`
**Why**: Explanation of why this works better.### Don't: Pattern Name
**Problem**:
\`\`\`
// Don't do this
bad code example
\`\`\`
**Why it's bad**: Explanation of the issue.
**Instead**:
\`\`\`
// Do this instead
good code example
\`\`\`### Common Mistake: Description
**Symptom**: What goes wrong
**Cause**: Why this happens
**Fix**: How to correct it
**Prevention**: How to avoid it in the future> **Warning**: Brief description of the non-obvious behavior.
>
> Details about when this happens and how to handle it.If you're unsure what to update, answer these prompts:
What did you just finish?
What did you learn or decide?
Would future AI/developers need to know this?
Which area does it relate to?
Before finishing your code-spec update:
Development Flow:
Learn something → `update-spec` (Trellis command) → Knowledge captured
↑ ↓
`break-loop` (Trellis command) ←──────────────────── Future sessions benefit
(deep bug analysis) (Trellis command) - Analyzes bugs deeply, often reveals spec updates needed (Trellis command) - Actually makes the updates (Trellis command) - Reminds you to check if specs need updatesCode-specs are living documents. Every debugging session, every "aha moment" is an opportunity to make the implementation contract clearer.
The goal is institutional memory:
© anjiemo, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .agents/skills/trellis-update-spec of anjiemo/SunnyBeach.
Open the folder on GitHubat commit ec2bf56
We found 25 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 7 other GitHub owners. This page covers the copy in anjiemo/SunnyBeach, which our catalogue first saw on October 7, 2026.
Trellis Update Spec next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Trellis Update Spec this skillanjiemo/SunnyBeach | 178 | 7 repos | ~2.8k | Automated safety check: Pass | Apache-2.0 | |
| Vercel Composition Patternssupabase/supabase | 111k | 58 repos | ~726 | Automated safety check: Pass | MIT | |
| Finishing a Development Branchobra/superpowers | 297k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Typescript Advanced Typesrolling-scopes/rsschool-app | 10k | 25 repos | ~4.2k | Automated safety check: Pass | MPL-2.0 | |
| PR Babysitteropeninterpreter/openinterpreter | 69k | 3 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Code Review ChecklistshareAI-lab/learn-claude-code | 78k | 5 repos | ~1.1k | Automated safety check: Pass | MIT |
supabase/supabase
React composition patterns that scale. An agent skill from supabase/supabase.
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
rolling-scopes/rsschool-app
Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
shareAI-lab/learn-claude-code
Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.
onyx-dot-app/onyx
Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.
anjiemo/SunnyBeach
Guides collaborative requirements discovery before implementation.
anjiemo/SunnyBeach
Comprehensive quality verification: spec compliance, lint, type-check, tests, cross-layer data flow, code reuse, and consistency checks.
anjiemo/SunnyBeach
Bootstrap project-specific Trellis coding specs with a platform-neutral single-agent workflow.
anjiemo/SunnyBeach
Deep bug analysis to break the fix-forget-repeat cycle. An agent skill from anjiemo/SunnyBeach.
anjiemo/SunnyBeach
Discovers and injects project-specific coding guidelines from .trellis/spec/ before implementation begins.
anjiemo/SunnyBeach
Understand and customize the local Trellis architecture inside a user project.
Categories
Captures executable contracts and coding conventions into .trellis/spec/ documents. Trellis Update Spec is an agent skill from anjiemo/SunnyBeach.trellis/spec/ documents.
Trellis Update Spec fits situations like: learning something valuable from debugging; discussion that should be preserved for future sessions.
Run `npx skills add anjiemo/SunnyBeach --skill trellis-update-spec -a claude-code`. Or copy the skill folder (.agents/skills/trellis-update-spec in anjiemo/SunnyBeach) into .claude/skills/trellis-update-spec in your project. Claude Code loads it when a task matches its description.
Run `npx skills add anjiemo/SunnyBeach --skill trellis-update-spec -a codex`. Or copy the skill folder (.agents/skills/trellis-update-spec in anjiemo/SunnyBeach) into .agents/skills/trellis-update-spec in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add anjiemo/SunnyBeach --skill trellis-update-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trellis-update-spec, .gemini/skills/trellis-update-spec, .github/skills/trellis-update-spec and .opencode/skills/trellis-update-spec in your project.
SKILL.md names no scripts, command-line tools or credentials: Trellis Update Spec is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Trellis Update Spec is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Trellis Update Spec: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
anjiemo (a GitHub user) maintains it in anjiemo/SunnyBeach, which has 178 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 11, 2026.
Source: anjiemo/SunnyBeach on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.