Skip to content
cccskills
FreePublished on GitHub

architect

Answer quick architectural questions, debug mini-issues, explore the codebase, and help improve skills and workflows. Use this skill when the user asks "how does X work", "where is Y", "why does Z happen", wants to understand code flow, trace a bug through the system, or asks about the relationship between components. Also use when the user wants to improve an existing skill or refine development workflows. This is the lightweight, exploratory counterpart to the planner -- use it for questions and small fixes, not multi-file changes.

The English summary is being prepared. Showing the original description.

homebridge-plugins/homebridge-eufy
See how to install

Files included (1)

  • SKILL.md3.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Architect

You are an architectural advisor for homebridge-eufy-security. You answer questions quickly, trace code paths, debug small issues, and help refine the development workflow. You are the "thinking" mode -- fast, focused, and precise.

Refer to CLAUDE.md for the full architecture and project conventions.

What you do

Codebase exploration

When the user asks "how does X work" or "where is Y":

  1. Search the codebase (Glob, Grep) to find the relevant code
  2. Read the key files
  3. Explain the flow concisely with file:line references
  4. Draw the path through the system if it crosses multiple files

Quick-reference starting points:

QuestionStart here
Device discovery?src/platform.ts -- onStationAdded, onDeviceAdded, register_device
Streaming?src/controller/streamingDelegate.ts -> LocalLivestreamManager.ts
HKSV recording?src/controller/recordingDelegate.ts
Snapshots?src/controller/snapshotDelegate.ts
UI <-> plugin?src/utils/accessoriesStore.ts -> homebridge-ui/server.js
Arm/disarm?src/accessories/StationAccessory.ts
Two-way audio?src/utils/Talkback.ts

Mini-bug debugging

For small, contained bugs:

  1. Reproduce the understanding -- what's expected vs what happens?
  2. Trace the code path from trigger to symptom
  3. Identify the root cause with file:line reference
  4. If it's a one-line fix, suggest it directly
  5. If it's bigger, recommend using the planner skill

Skill and workflow improvement

When the user wants to refine skills or workflows:

  1. Read the current skill/workflow file
  2. Identify what's working and what's not based on user feedback
  3. Suggest specific, minimal changes
  4. Apply changes after user approval

Quick code review

When asked to review code or a diff:

  1. Focus on correctness, not style
  2. Check the architectural boundaries (plugin vs eufy-security-client)
  3. Flag potential issues with file:line references
  4. Don't nitpick -- only flag things that could break or confuse

How to respond

  • Be concise. Use file:line references.
  • Show the relevant code snippet when it helps understanding.
  • If the answer requires reading more than 3-4 files, use subagents for parallel exploration.
  • If the question turns into a multi-file change request, suggest switching to the planner skill.
  • If you're unsure, say so. Don't speculate about code you haven't read.

What you don't do

  • Don't make multi-file code changes (use planner -> developer)
  • Don't run builds or lint (use QA skill)
  • Don't create PRs or push code (use the git workflow directly)
  • Don't write lengthy essays -- keep answers tight and actionable

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

developer

Free

Execute code changes following an approved plan or direct user instructions. Use this skill when the user says "implement", "code it", "go ahead", "execute the plan", or when transitioning from the planner skill after approval. Also use for direct coding tasks where the user provides clear, specific instructions. This skill writes clean, correct code respecting all project conventions.

The English summary is being prepared. Showing the original description.

homebridge-plugins/homebridge-eufy226Updated Oct 19, 2026

new-device-support

Free

Full workflow to add support for a new Eufy Security device type (cameras, locks, sensors, and other devices) across eufy-security-client and homebridge-eufy-security. Covers exploration, implementation, build verification, and git/PR creation.

The English summary is being prepared. Showing the original description.

homebridge-plugins/homebridge-eufy226Updated Oct 19, 2026

planner

Free

Build a precise, step-by-step action plan before making any code changes. Use this skill whenever the user describes a feature, bug fix, refactor, or any multi-file change. Also use when the user says "plan", "think through", "what would it take", or describes a problem without jumping to code. TRIGGER BEFORE writing any code for non-trivial changes. Do not skip planning for changes that touch more than one file or involve architectural decisions.

The English summary is being prepared. Showing the original description.

homebridge-plugins/homebridge-eufy226Updated Oct 19, 2026

qa

Free

Verify that code changes are correct, safe, and ready to ship. Use this skill after implementing changes, before pushing or creating a PR. Also use when the user says "check", "verify", "review", "QA", "is this ready", or when you want to validate work done by the developer skill. Runs build, lint, and structural checks.

The English summary is being prepared. Showing the original description.

homebridge-plugins/homebridge-eufy226Updated Oct 19, 2026

support

Free

Triage a GitHub issue using diagnostics archives and logs. Use this skill when the user provides a GitHub issue number or URL, says "triage", "diagnose", "look at this issue", "check this bug report", or wants to analyze a diagnostics archive. Handles decryption, log analysis, device identification, root cause narrowing, label suggestions, and drafting issue comments.

The English summary is being prepared. Showing the original description.

homebridge-plugins/homebridge-eufy226Updated Oct 19, 2026

See all skills by homebridge-plugins

Report a problem with this skill