Load and validate runtime configuration for SquareOne apps with AppConfig.
npx skills add https://github.com/lsst-sqre/squareone --skill appconfig-system
Please help me install this Agent Skill. Skill: appconfig-system Source: https://github.com/lsst-sqre/squareone/tree/main/.claude/skills/appconfig-system Command: npx skills add https://github.com/lsst-sqre/squareone --skill appconfig-system
Managing application configuration, especially in a Next.js app deployed to Kubernetes, can lead to hydration issues, lack of type safety, and complex deployment workflows. This skill provides expert guidance on the AppConfig system, offering a robust, type-safe, and Kubernetes-friendly solution for runtime configuration.
loadAppConfig(), client-side useAppConfig(), and MDX content loading, ensuring consistent configuration access.squareone.config.yaml, load them via getServerSideProps, and access them in components using useAppConfig().Load the application configuration on the server-side for a Next.js page.
import { loadAppConfig } from '../lib/config/loader'; const appConfig = await loadAppConfig();
High-intent search queries and answers about installing and using this skill.
Runtime configuration in Next.js can be managed through the AppConfig system, which loads YAML configuration files via `loadAppConfig()` on the server and `useAppConfig()` on the client. This approach eliminates hydration issues, provides type-safe access through JSON schema validation, and integrates seamlessly with Kubernetes ConfigMaps for deployment.
Yes. The AppConfig system uses Ajv-based JSON schema validation on YAML configuration files, providing full TypeScript support and automatic property validation with defaults. Unknown properties are removed and environment variable overrides are applied, ensuring type-safe configuration access across server and client code.
Use `loadAppConfig()` in `getServerSideProps` to load server-side configuration, then pass it to components. On the client, access configuration through `useAppConfig()`. For MDX content, use `loadConfigAndMdx()` to load both configuration and content together, ensuring consistent access patterns.
Yes. The AppConfig system supports Sentry configuration injection and Kubernetes ConfigMap patterns, simplifying operations and error tracking in containerized environments. Configuration caching and environment variable overrides ensure flexible deployment across different environments.
YAML configuration requires valid schema definition and JSON schema setup. The AppConfig system mitigates complexity through Ajv validation and automatic unknown property removal, but schema design and environment variable override logic must be properly configured to avoid misconfiguration.
mvillmowValidate agent YAML frontmatter and configuration files.
kws-projectsIntegrate Google Analytics 4 and Sentry for event tracking and error monitoring.
JosiahSiegelProvide TypeScript patterns for React component props, events, hooks, and generics.
Snowflake-LabsA concise summary of your roleplay character: name,</name> personality, and/or behavior, formatted as a single string sentence. Typically不超过50字，此处省略