[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CT2CHR5T3FHTSG9K6HXN27":3,"skill-same:01M6CT2CHR5T3FHTSG9K6HXN27":64},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":25,"linkOnly":26,"markdownContent":27,"markdownBody":28,"frontMatter":29,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":14,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":35,"install":36,"resources":49},"01M6CT2CHR5T3FHTSG9K6HXN27","conventions",null,"OTel observability conventions: span naming, attribute keys, PII rules, and sampling configuration","lucid-fdn\u002Flucid-plugins","lucid-fdn","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F93290671?v=4","01M6CT12EHKN5DWVD9NAK6WSXT","Lucid","01M6CT12K0ARYZ8D28MK4G89F8",0,"MIT","https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-observability\u002Fskill\u002Freferences\u002Fconventions\u002FSKILL.md",[],[5,19,20,21,22,23,24],"otel","observability","pii","Rules","sampling","configuration","2026-11-10 10:12:30",false,"---\nname: conventions\ndescription: \"OTel observability conventions: span naming, attribute keys, PII rules, and sampling configuration\"\n---\n\n# Observability Conventions\n\nStandard conventions for OpenTelemetry instrumentation across the Lucid platform.\n\n## The 6 Rules\n\n1. **Identity keys** (tenant_key, session_key, user_key) **MUST** be hashed via `hashForTelemetry()` — they are PII\n2. **UUIDs** (run_id, conversation_id, message_id) are OK raw — they are NOT PII\n3. UUIDs are **HIGH CARDINALITY** — NEVER use as metric labels\n4. **Content** (plaintext, ciphertext, prompts, tool args) is **NEVER** an attribute\n5. Use `LUCID_ENV` not `NODE_ENV` for environment detection\n6. All services use **head + tail sampling**: head captures baseline, tail captures 100% errors\n\n## Span Names\n\nSee [references\u002Fspan-names.md](references\u002Fspan-names.md) for the canonical list of 20 span names and their descriptions.\n\nWhen reviewing or writing instrumentation code:\n- Use exact span names from the reference list\n- Each span name maps to a specific operation\n- New span names should follow the `domain.operation` pattern\n\n## Attribute Keys\n\nSee [references\u002Fattributes.md](references\u002Fattributes.md) for all 19 standard attribute keys with PII and cardinality flags.\n\nWhen reviewing attributes:\n- Check PII flag — PII attributes MUST be hashed\n- Check high cardinality flag — high cardinality attributes MUST NOT be metric labels\n- Use the exact key names from the reference list\n\n## Sampling\n\nSee [references\u002Fsampling.md](references\u002Fsampling.md) for head\u002Ftail sampling configuration.\n\n## Convention Compliance Check\n\nWhen auditing a service for convention compliance:\n\n1. **Verify service is in the topology** — check correlation\u002Freferences\u002Fservices.md\n2. **Check Sentry project exists** — verify the sentryProject mapping\n3. **Check span names** — service should implement spans that match its domain prefix\n4. **Check PII handling** — all PII attributes must use `hashForTelemetry()`\n5. **Check sampling config** — verify rates match the environment\n6. **Check LUCID_ENV** — must be set, not relying on NODE_ENV\n","# Observability Conventions\n\nStandard conventions for OpenTelemetry instrumentation across the Lucid platform.\n\n## The 6 Rules\n\n1. **Identity keys** (tenant_key, session_key, user_key) **MUST** be hashed via `hashForTelemetry()` — they are PII\n2. **UUIDs** (run_id, conversation_id, message_id) are OK raw — they are NOT PII\n3. UUIDs are **HIGH CARDINALITY** — NEVER use as metric labels\n4. **Content** (plaintext, ciphertext, prompts, tool args) is **NEVER** an attribute\n5. Use `LUCID_ENV` not `NODE_ENV` for environment detection\n6. All services use **head + tail sampling**: head captures baseline, tail captures 100% errors\n\n## Span Names\n\nSee [references\u002Fspan-names.md](references\u002Fspan-names.md) for the canonical list of 20 span names and their descriptions.\n\nWhen reviewing or writing instrumentation code:\n- Use exact span names from the reference list\n- Each span name maps to a specific operation\n- New span names should follow the `domain.operation` pattern\n\n## Attribute Keys\n\nSee [references\u002Fattributes.md](references\u002Fattributes.md) for all 19 standard attribute keys with PII and cardinality flags.\n\nWhen reviewing attributes:\n- Check PII flag — PII attributes MUST be hashed\n- Check high cardinality flag — high cardinality attributes MUST NOT be metric labels\n- Use the exact key names from the reference list\n\n## Sampling\n\nSee [references\u002Fsampling.md](references\u002Fsampling.md) for head\u002Ftail sampling configuration.\n\n## Convention Compliance Check\n\nWhen auditing a service for convention compliance:\n\n1. **Verify service is in the topology** — check correlation\u002Freferences\u002Fservices.md\n2. **Check Sentry project exists** — verify the sentryProject mapping\n3. **Check span names** — service should implement spans that match its domain prefix\n4. **Check PII handling** — all PII attributes must use `hashForTelemetry()`\n5. **Check sampling config** — verify rates match the environment\n6. **Check LUCID_ENV** — must be set, not relying on NODE_ENV\n",{"name":5,"description":7},"main","60a187a694df4ce725464b7578e08ad46a73340f","lucid-observability\u002Fskill\u002Freferences\u002Fconventions","https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins","https:\u002F\u002Fgithub.com\u002Flucid-fdn","2026-03-26 06:06:06",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add lucid-fdn\u002Flucid-plugins --skill conventions",{"tool":42,"command":43},"bunx","bunx skills add lucid-fdn\u002Flucid-plugins --skill conventions",{"tool":45,"command":46},"pnpm","pnpm dlx skills add lucid-fdn\u002Flucid-plugins --skill conventions","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-observability\u002Fskill\u002Freferences\u002Fconventions\u002FSKILL.md",true,[50,56,60],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fattributes.md","REFERENCE","参考文档",1869,"https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-observability\u002Fskill\u002Freferences\u002Fconventions\u002Freferences\u002Fattributes.md",{"path":57,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fsampling.md",1294,"https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-observability\u002Fskill\u002Freferences\u002Fconventions\u002Freferences\u002Fsampling.md",{"path":61,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fspan-names.md",1523,"https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-observability\u002Fskill\u002Freferences\u002Fconventions\u002Freferences\u002Fspan-names.md",[65,74,99,111,127,146],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":25},"01M6CT442ZA942TW2E4GM9B47B","lucid-PLUGIN_NAME","PLUGIN_DESCRIPTION","https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Ftemplates\u002Fplugin-template\u002Fdocs\u002FSKILL.md",[],[72,73],"lucid PLUGIN NAME","plugin",{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":90,"publishedAt":25},"01M6CT41PA1EKESRMFV5V775TW","social-content","Generate short-form video content optimized for social media platforms","https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-video\u002Fskill\u002Freferences\u002Fsocial-content\u002FSKILL.md",[80,85],{"categoryNo":81,"categoryName":82,"taxonomyType":83,"taxonomyTypeDesc":84},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",{"categoryNo":86,"categoryName":87,"taxonomyType":88,"taxonomyTypeDesc":89},"01JBSEEDCAT000000000000036","内容创作者","PROFESSION","适用职业",[91,92,93,94,95,96,97,98],"social","social content","content","short","social media","Media","Video","generate",{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":106,"publishedAt":25},"01M6CT3Z4SPEJQYJNZ60ZBDKMF","personalized-outreach","Generate 1:1 personalized video for sales prospecting and customer success","https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-video\u002Fskill\u002Freferences\u002Fpersonalized-outreach\u002FSKILL.md",[105],{"categoryNo":81,"categoryName":82,"taxonomyType":83,"taxonomyTypeDesc":84},[107,98,108,97,109,110],"personalized outreach","sales","prospecting","customer",{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":120,"publishedAt":25},"01M6CT3WH4C1TMMSWY25XBEM19","data-reports","Generate animated data report videos from KPIs, charts, and analytics","https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-video\u002Fskill\u002Freferences\u002Fdata-reports\u002FSKILL.md",[117],{"categoryNo":118,"categoryName":119,"taxonomyType":88,"taxonomyTypeDesc":89},"01JBSEEDCAT000000000000033","数据分析师",[121,122,123,124,125,98,126],"data","data reports","reports","Charts","report","analytics",{"skillNo":128,"name":129,"nameZh":6,"description":130,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":131,"categories":132,"keywords":137,"publishedAt":25},"01M6CT3TJTWDVGM0CY356RS99V","lucid-video","Agent-native video generation using Remotion — MCP server + OpenClaw plugin","https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-video\u002Fskill\u002FSKILL.md",[133,134],{"categoryNo":81,"categoryName":82,"taxonomyType":83,"taxonomyTypeDesc":84},{"categoryNo":135,"categoryName":136,"taxonomyType":83,"taxonomyTypeDesc":84},"01JBSEEDCAT000000000000023","Skill与智能体开发",[138,97,139,140,141,142,143,144,145,73],"lucid video","server","MCP","openclaw","mcp server","openclaw plugin","video generation","Remotion",{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":150,"categories":151,"keywords":152,"publishedAt":25},"01M6CT3RP3ZWEJBA5Q3X8J4XV4","lucid-veille","Content monitoring, AI digest generation, and multi-platform auto-publishing","https:\u002F\u002Fgithub.com\u002Flucid-fdn\u002Flucid-plugins\u002Fblob\u002Fmain\u002Flucid-veille\u002Fskill\u002Freferences\u002Flucid-veille\u002FSKILL.md",[],[153,154,155,156,157,158,93],"lucid veille","supabase","monitoring","auto","publishing","digest"]