Agent skill

backend-development

Integration-first development patterns for Encore.ts backend services. Focuses on importing subscriptions, polling async flows, verifying database state, and keeping diagnostic tooling close at hand.

View SKILL.md on GitHub Repository
Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/nirukk52/ScreenGraph/tree/main/.claude-skills/backend-development_skill

SKILL.md

Backend Development Skill

Mission

Ship reliable Encore.ts services by exercising the full flow—API call, worker execution, projector persistence, and database validation—inside every test cycle. This skill outlines the core loop and points to detailed playbooks in references/.

When to Use

  • Creating or updating Encore.ts services or subscriptions
  • Writing integration tests that cover PubSub + database interactions
  • Diagnosing flaky backend tests before handing off to QA or FE
  • Preparing backend changes for CI, smoke tests, or release gates

Development Loop

  1. Plan the flow – Identify required subscriptions, services, and database tables; note expectations in Graphiti.
  2. Import dependencies – Bring subscriptions/services into the test runtime to mirror production wiring.
  3. Execute via Encore client – Call the service using generated types, not manual fetches.
  4. Poll for completion – Use polling helpers (no fixed sleeps) until the worker finishes or times out.
  5. Assert database + logs – Verify rows, outcomes, and structured log fields against expectations.
  6. Clean up + document – Remove test data, note findings in Graphiti, and link any new scripts or helpers.

Quick Command Set

bash
cd backend && encore dev          # Local dev server
cd backend && encore test         # Full test suite
cd backend && encore test path/to.test.ts  # Focused integration test
cd .cursor && task backend:test   # Automation layer entry point
cd .cursor && task backend:logs   # Stream structured logs

Quality Gates

  • Subscriptions imported for every PubSub interaction
  • Services and repositories typed end-to-end (no any or untyped SQL results)
  • Polling loops with bounded timeouts instead of setTimeout
  • Database cleaned after each integration test run
  • Structured logging uses encore.dev/log with module, actor, and identifiers

Reference Library

  • references/integration_test_patterns.md – Step-by-step pattern for polling, cleanup, and database verification
  • references/api_testing_examples.md – Example tests covering multi-service flows and assertions
  • references/encore_mcp_testing_patterns.md – How to combine Encore MCP with tests for live introspection
  • WEBDRIVER_SESSION_ERRORS.md – Known Appium/WebDriver error catalog used during agent-driven tests

Related Skills

  • backend-debugging_skill – Deep-dive diagnostics when runs stall or regressions persist
  • e2e-testing_skill – Playwright automation that consumes backend APIs end-to-end
  • graphiti-mcp-usage_skill – Document backend architecture and test discoveries in Graphiti

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

nirukk52/ScreenGraph

before-task

Comprehensive discovery before starting any spec or major task. Searches Graphiti, recommends vibe/MCPs, surfaces patterns.

1 0
Explore
nirukk52/ScreenGraph

e2e-testing

Playwright end-to-end testing for ScreenGraph using .env-driven configuration. Use when validating full user flows, running regression suites, or inspecting UI behavior with Cursor browser tools.

1 0
Explore
nirukk52/ScreenGraph

slack-gif-creator

Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like "make me a GIF for Slack of X doing Y".

1 0
Explore
nirukk52/ScreenGraph

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

1 0
Explore
nirukk52/ScreenGraph

after-task

Mandatory knowledge capture after completing work. Documents solution in Graphiti and tracks effectiveness for system improvement.

1 0
Explore
nirukk52/ScreenGraph

canvas-design

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

1 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results