[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75G8KXDCJ73P9NWDJFTPVZM":3,"skill-same:01M75G8KXDCJ73P9NWDJFTPVZM":50},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M75G8KXDCJ73P9NWDJFTPVZM","python-configuration",null,"Python configuration management via environment variables and typed settings. Use when externalizing config, setting up pydantic-settings, managing secrets, or implementing environment-specific behavior.","RudyCity\u002Fsuperagent","RudyCity","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F82188919?v=4","01M75FP5X8AW8ACBH0SH34WS7M","01M75FP5YAHJK8M1Q52BWXB82K",70,"MIT","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fpython-configuration\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: python-configuration\ndescription: Python configuration management via environment variables and typed settings. Use when externalizing config, setting up pydantic-settings, managing secrets, or implementing environment-specific behavior.\n---\n\n# Python Configuration Management\n\nExternalize configuration from code using environment variables and typed settings. Well-managed configuration enables the same code to run in any environment without modification.\n\n## When to Use This Skill\n\n- Setting up a new project's configuration system\n- Migrating from hardcoded values to environment variables\n- Implementing pydantic-settings for typed configuration\n- Managing secrets and sensitive values\n- Creating environment-specific settings (dev\u002Fstaging\u002Fprod)\n- Validating configuration at application startup\n\n## Core Concepts\n\n### 1. Externalized Configuration\n\nAll environment-specific values (URLs, secrets, feature flags) come from environment variables, not code.\n\n### 2. Typed Settings\n\nParse and validate configuration into typed objects at startup, not scattered throughout code.\n\n### 3. Fail Fast\n\nValidate all required configuration at application boot. Missing config should crash immediately with a clear message.\n\n### 4. Sensible Defaults\n\nProvide reasonable defaults for local development while requiring explicit values for sensitive settings.\n\n## Quick Start\n\n```python\nfrom pydantic_settings import BaseSettings\nfrom pydantic import Field\n\nclass Settings(BaseSettings):\n    database_url: str = Field(alias=\"DATABASE_URL\")\n    api_key: str = Field(alias=\"API_KEY\")\n    debug: bool = Field(default=False, alias=\"DEBUG\")\n\nsettings = Settings()  # Loads from environment\n```\n\n## Fundamental Patterns\n\n### Pattern 1: Typed Settings with Pydantic\n\nCreate a central settings class that loads and validates all configuration.\n\n```python\nfrom pydantic_settings import BaseSettings\nfrom pydantic import Field, PostgresDsn, ValidationError\nimport sys\n\nclass Settings(BaseSettings):\n    \"\"\"Application configuration loaded from environment variables.\"\"\"\n\n    # Database\n    db_host: str = Field(alias=\"DB_HOST\")\n    db_port: int = Field(default=5432, alias=\"DB_PORT\")\n    db_name: str = Field(alias=\"DB_NAME\")\n    db_user: str = Field(alias=\"DB_USER\")\n    db_password: str = Field(alias=\"DB_PASSWORD\")\n\n    # Redis\n    redis_url: str = Field(default=\"redis:\u002F\u002Flocalhost:6379\", alias=\"REDIS_URL\")\n\n    # API Keys\n    api_secret_key: str = Field(alias=\"API_SECRET_KEY\")\n\n    # Feature flags\n    enable_new_feature: bool = Field(default=False, alias=\"ENABLE_NEW_FEATURE\")\n\n    model_config = {\n        \"env_file\": \".env\",\n        \"env_file_encoding\": \"utf-8\",\n    }\n\n# Create singleton instance at module load\ntry:\n    settings = Settings()\nexcept ValidationError as e:\n    print(f\"Configuration error:\\n{e}\")\n    sys.exit(1)\n```\n\nImport `settings` throughout your application:\n\n```python\nfrom myapp.config import settings\n\ndef get_database_connection():\n    return connect(\n        host=settings.db_host,\n        port=settings.db_port,\n        database=settings.db_name,\n    )\n```\n\n### Pattern 2: Fail Fast on Missing Configuration\n\nRequired settings should crash the application immediately with a clear error.\n\n```python\nfrom pydantic_settings import BaseSettings\nfrom pydantic import Field, ValidationError\nimport sys\n\nclass Settings(BaseSettings):\n    # Required - no default means it must be set\n    api_key: str = Field(alias=\"API_KEY\")\n    database_url: str = Field(alias=\"DATABASE_URL\")\n\n    # Optional with defaults\n    log_level: str = Field(default=\"INFO\", alias=\"LOG_LEVEL\")\n\ntry:\n    settings = Settings()\nexcept ValidationError as e:\n    print(\"=\" * 60)\n    print(\"CONFIGURATION ERROR\")\n    print(\"=\" * 60)\n    for error in e.errors():\n        field = error[\"loc\"][0]\n        print(f\"  - {field}: {error['msg']}\")\n    print(\"\\nPlease set the required environment variables.\")\n    sys.exit(1)\n```\n\nA clear error at startup is better than a cryptic `None` failure mid-request.\n\n### Pattern 3: Local Development Defaults\n\nProvide sensible defaults for local development while requiring explicit values for secrets.\n\n```python\nclass Settings(BaseSettings):\n    # Has local default, but prod will override\n    db_host: str = Field(default=\"localhost\", alias=\"DB_HOST\")\n    db_port: int = Field(default=5432, alias=\"DB_PORT\")\n\n    # Always required - no default for secrets\n    db_password: str = Field(alias=\"DB_PASSWORD\")\n    api_secret_key: str = Field(alias=\"API_SECRET_KEY\")\n\n    # Development convenience\n    debug: bool = Field(default=False, alias=\"DEBUG\")\n\n    model_config = {\"env_file\": \".env\"}\n```\n\nCreate a `.env` file for local development (never commit this):\n\n```bash\n# .env (add to .gitignore)\nDB_PASSWORD=local_dev_password\nAPI_SECRET_KEY=dev-secret-key\nDEBUG=true\n```\n\n### Pattern 4: Namespaced Environment Variables\n\nPrefix related variables for clarity and easy debugging.\n\n```bash\n# Database configuration\nDB_HOST=localhost\nDB_PORT=5432\nDB_NAME=myapp\nDB_USER=admin\nDB_PASSWORD=secret\n\n# Redis configuration\nREDIS_URL=redis:\u002F\u002Flocalhost:6379\nREDIS_MAX_CONNECTIONS=10\n\n# Authentication\nAUTH_SECRET_KEY=your-secret-key\nAUTH_TOKEN_EXPIRY_SECONDS=3600\nAUTH_ALGORITHM=HS256\n\n# Feature flags\nFEATURE_NEW_CHECKOUT=true\nFEATURE_BETA_UI=false\n```\n\nMakes `env | grep DB_` useful for debugging.\n\n## Detailed worked examples and patterns\n\nDetailed sections (starting with `## Advanced Patterns`) live in `references\u002Fdetails.md`. Read that file when the navigation summary above is insufficient.\n\n## Best Practices Summary\n\n1. **Never hardcode config** - All environment-specific values from env vars\n2. **Use typed settings** - Pydantic-settings with validation\n3. **Fail fast** - Crash on missing required config at startup\n4. **Provide dev defaults** - Make local development easy\n5. **Never commit secrets** - Use `.env` files (gitignored) or secret managers\n6. **Namespace variables** - `DB_HOST`, `REDIS_URL` for clarity\n7. **Import settings singleton** - Don't call `os.getenv()` throughout code\n8. **Document all variables** - README should list required env vars\n9. **Validate early** - Check config correctness at boot time\n10. **Use secrets_dir** - Support mounted secrets in containers\n","# Python Configuration Management\n\nExternalize configuration from code using environment variables and typed settings. Well-managed configuration enables the same code to run in any environment without modification.\n\n## When to Use This Skill\n\n- Setting up a new project's configuration system\n- Migrating from hardcoded values to environment variables\n- Implementing pydantic-settings for typed configuration\n- Managing secrets and sensitive values\n- Creating environment-specific settings (dev\u002Fstaging\u002Fprod)\n- Validating configuration at application startup\n\n## Core Concepts\n\n### 1. Externalized Configuration\n\nAll environment-specific values (URLs, secrets, feature flags) come from environment variables, not code.\n\n### 2. Typed Settings\n\nParse and validate configuration into typed objects at startup, not scattered throughout code.\n\n### 3. Fail Fast\n\nValidate all required configuration at application boot. Missing config should crash immediately with a clear message.\n\n### 4. Sensible Defaults\n\nProvide reasonable defaults for local development while requiring explicit values for sensitive settings.\n\n## Quick Start\n\n```python\nfrom pydantic_settings import BaseSettings\nfrom pydantic import Field\n\nclass Settings(BaseSettings):\n    database_url: str = Field(alias=\"DATABASE_URL\")\n    api_key: str = Field(alias=\"API_KEY\")\n    debug: bool = Field(default=False, alias=\"DEBUG\")\n\nsettings = Settings()  # Loads from environment\n```\n\n## Fundamental Patterns\n\n### Pattern 1: Typed Settings with Pydantic\n\nCreate a central settings class that loads and validates all configuration.\n\n```python\nfrom pydantic_settings import BaseSettings\nfrom pydantic import Field, PostgresDsn, ValidationError\nimport sys\n\nclass Settings(BaseSettings):\n    \"\"\"Application configuration loaded from environment variables.\"\"\"\n\n    # Database\n    db_host: str = Field(alias=\"DB_HOST\")\n    db_port: int = Field(default=5432, alias=\"DB_PORT\")\n    db_name: str = Field(alias=\"DB_NAME\")\n    db_user: str = Field(alias=\"DB_USER\")\n    db_password: str = Field(alias=\"DB_PASSWORD\")\n\n    # Redis\n    redis_url: str = Field(default=\"redis:\u002F\u002Flocalhost:6379\", alias=\"REDIS_URL\")\n\n    # API Keys\n    api_secret_key: str = Field(alias=\"API_SECRET_KEY\")\n\n    # Feature flags\n    enable_new_feature: bool = Field(default=False, alias=\"ENABLE_NEW_FEATURE\")\n\n    model_config = {\n        \"env_file\": \".env\",\n        \"env_file_encoding\": \"utf-8\",\n    }\n\n# Create singleton instance at module load\ntry:\n    settings = Settings()\nexcept ValidationError as e:\n    print(f\"Configuration error:\\n{e}\")\n    sys.exit(1)\n```\n\nImport `settings` throughout your application:\n\n```python\nfrom myapp.config import settings\n\ndef get_database_connection():\n    return connect(\n        host=settings.db_host,\n        port=settings.db_port,\n        database=settings.db_name,\n    )\n```\n\n### Pattern 2: Fail Fast on Missing Configuration\n\nRequired settings should crash the application immediately with a clear error.\n\n```python\nfrom pydantic_settings import BaseSettings\nfrom pydantic import Field, ValidationError\nimport sys\n\nclass Settings(BaseSettings):\n    # Required - no default means it must be set\n    api_key: str = Field(alias=\"API_KEY\")\n    database_url: str = Field(alias=\"DATABASE_URL\")\n\n    # Optional with defaults\n    log_level: str = Field(default=\"INFO\", alias=\"LOG_LEVEL\")\n\ntry:\n    settings = Settings()\nexcept ValidationError as e:\n    print(\"=\" * 60)\n    print(\"CONFIGURATION ERROR\")\n    print(\"=\" * 60)\n    for error in e.errors():\n        field = error[\"loc\"][0]\n        print(f\"  - {field}: {error['msg']}\")\n    print(\"\\nPlease set the required environment variables.\")\n    sys.exit(1)\n```\n\nA clear error at startup is better than a cryptic `None` failure mid-request.\n\n### Pattern 3: Local Development Defaults\n\nProvide sensible defaults for local development while requiring explicit values for secrets.\n\n```python\nclass Settings(BaseSettings):\n    # Has local default, but prod will override\n    db_host: str = Field(default=\"localhost\", alias=\"DB_HOST\")\n    db_port: int = Field(default=5432, alias=\"DB_PORT\")\n\n    # Always required - no default for secrets\n    db_password: str = Field(alias=\"DB_PASSWORD\")\n    api_secret_key: str = Field(alias=\"API_SECRET_KEY\")\n\n    # Development convenience\n    debug: bool = Field(default=False, alias=\"DEBUG\")\n\n    model_config = {\"env_file\": \".env\"}\n```\n\nCreate a `.env` file for local development (never commit this):\n\n```bash\n# .env (add to .gitignore)\nDB_PASSWORD=local_dev_password\nAPI_SECRET_KEY=dev-secret-key\nDEBUG=true\n```\n\n### Pattern 4: Namespaced Environment Variables\n\nPrefix related variables for clarity and easy debugging.\n\n```bash\n# Database configuration\nDB_HOST=localhost\nDB_PORT=5432\nDB_NAME=myapp\nDB_USER=admin\nDB_PASSWORD=secret\n\n# Redis configuration\nREDIS_URL=redis:\u002F\u002Flocalhost:6379\nREDIS_MAX_CONNECTIONS=10\n\n# Authentication\nAUTH_SECRET_KEY=your-secret-key\nAUTH_TOKEN_EXPIRY_SECONDS=3600\nAUTH_ALGORITHM=HS256\n\n# Feature flags\nFEATURE_NEW_CHECKOUT=true\nFEATURE_BETA_UI=false\n```\n\nMakes `env | grep DB_` useful for debugging.\n\n## Detailed worked examples and patterns\n\nDetailed sections (starting with `## Advanced Patterns`) live in `references\u002Fdetails.md`. Read that file when the navigation summary above is insufficient.\n\n## Best Practices Summary\n\n1. **Never hardcode config** - All environment-specific values from env vars\n2. **Use typed settings** - Pydantic-settings with validation\n3. **Fail fast** - Crash on missing required config at startup\n4. **Provide dev defaults** - Make local development easy\n5. **Never commit secrets** - Use `.env` files (gitignored) or secret managers\n6. **Namespace variables** - `DB_HOST`, `REDIS_URL` for clarity\n7. **Import settings singleton** - Don't call `os.getenv()` throughout code\n8. **Document all variables** - README should list required env vars\n9. **Validate early** - Check config correctness at boot time\n10. **Use secrets_dir** - Support mounted secrets in containers\n",{"name":5,"description":7},"main","62c7af5ced2c21355d148c243edb6d5921cca1a6",".agents\u002Fskills\u002Fpython-configuration",8,"https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent","https:\u002F\u002Fgithub.com\u002FRudyCity","2026-11-14 22:58:49",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add RudyCity\u002Fsuperagent --skill python-configuration",{"tool":36,"command":37},"bunx","bunx skills add RudyCity\u002Fsuperagent --skill python-configuration",{"tool":39,"command":40},"pnpm","pnpm dlx skills add RudyCity\u002Fsuperagent --skill python-configuration","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fpython-configuration\u002FSKILL.md",true,[44],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"references\u002Fdetails.md","REFERENCE","参考文档",4011,"https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fpython-configuration\u002Freferences\u002Fdetails.md",[51,58,65,72,79,86],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M75GP28CM6QCSXSHKFF3NNKS","telegram_bot","Use Telegram Bot when the user asks for Telegram Bot or this provider's API.","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002Fmuse-bridge-kit\u002Fskills\u002Ftelegram-bot\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M75GNZGZYM7NWDV6MBP3HS14","superagent-bridge","Operate the Muse\u003C->superagent Telegram bridge: poll the private group for task_request\u002Ftask_result envelopes, validate senders, and reply with task_batch\u002Ftask_done as Muse (the remote brain).","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002Fmuse-bridge-kit\u002Fskills\u002Fsuperagent-bridge\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M75GNHN19HJWZ7NAPM5E5JCV","Writing Skills","TDD for process documentation - test with subagents before writing, iterate until bulletproof","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M75GNCQEKVRA4FH161NZPZNB","writing-shape","Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format (lists, tables, callouts, quotes) at each step. Use when the user has a pile of notes, fragments, or a rough draft and wants help turning it into something publishable.","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-shape\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M75GNAF9NAYCSTBDZDGMK0DZ","Writing Plans","Create detailed implementation plans with bite-sized tasks for engineers with zero codebase context","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":18},"01M75GN72EV0V5NQAW9CSPFRFH","writing-guidelines","Review docs\u002Fprose for Writing Guidelines compliance. Use when asked to \"review my docs\", \"check writing style\", \"audit prose\", \"review docs voice and tone\", or \"check this page against the writing handbook\".","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-guidelines\u002FSKILL.md",[],[]]