[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6KGHMTKSHZHBWVH2JZAHXF2":3,"skill-same:01M6KGHMTKSHZHBWVH2JZAHXF2":66},{"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":23,"publishedAt":40,"linkOnly":41,"markdownContent":42,"markdownBody":43,"frontMatter":44,"refName":45,"commitSha":46,"skillDirectory":47,"forksCount":48,"repositoryHtmlUrl":49,"repositoryHomepageUrl":6,"ownerHtmlUrl":50,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":51,"install":52,"resources":65},"01M6KGHMTKSHZHBWVH2JZAHXF2","organizing-streamlit-code",null,"Organizing Streamlit code for maintainability. Use when structuring apps with separate modules and utilities. Covers separation of concerns, keeping UI code clean, and import patterns.","legout\u002Fpi-config","legout","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1469563?v=4","01M6KGERP7E8TF4XARRKPFJ6HQ","Volker L.","01M6KGERT1FYD049PP1WW923TZ",3,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Flegout\u002Fpi-config\u002Fblob\u002Fmain\u002Finstalled-skills\u002Fdeveloping-with-streamlit\u002Fskills\u002Forganizing-streamlit-code\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"code","streamlit","organizing streamlit code","ui","use","modules","clean","patterns","maintainability","apps","separation of concerns","import","separation","Utilities","with","for","2026-11-10 10:12:30",false,"---\nname: organizing-streamlit-code\ndescription: Organizing Streamlit code for maintainability. Use when structuring apps with separate modules and utilities. Covers separation of concerns, keeping UI code clean, and import patterns.\nlicense: Apache-2.0\n---\n\n# Streamlit code organization\n\nFor most simple apps, keep everything in one file—it's cleaner and more straightforward. The app file should read like a normal Python script for data processing, with a few Streamlit commands sprinkled in.\n\nName the main file `streamlit_app.py` (Streamlit's default).\n\n## When to split\n\n**Keep in one file (most apps):**\n- Apps under ~1000 lines\n- One-off scripts and prototypes\n- Apps where logic is straightforward\n\n**Consider splitting when:**\n- Data processing is complex (50+ lines of non-UI code)\n- Multiple pages share logic\n- You want to test business logic separately\n\nIf splitting makes sense, here's how to organize it.\n\n## Directory structure\n\n```\nmy-app\u002F\n├── streamlit_app.py      # Main entry point\n├── app_pages\u002F            # Page UI modules\n│   ├── dashboard.py\n│   └── settings.py\n└── utils\u002F                # Business logic & helpers\n    ├── data.py\n    └── api.py\n```\n\n## Separating UI from logic\n\nWhen you do split, keep Streamlit files focused on UI and move complex logic to utility modules:\n\n```python\n# streamlit_app.py - UI-focused\nimport streamlit as st\nfrom utils.data import load_sales_data, compute_metrics\n\nst.title(\"Sales Dashboard\")\n\nstart = st.date_input(\"Start\")\nend = st.date_input(\"End\")\n\ndata = load_sales_data(start, end)\nmetrics = compute_metrics(data)\n\nst.metric(\"Revenue\", f\"${metrics['revenue']:,.0f}\")\nst.dataframe(data)\n```\n\n## Avoid if __name__ == \"__main__\"\n\nStreamlit apps run the entire file on each interaction. Don't use the main guard in Streamlit files.\n\n```python\n# BAD - don't do this in streamlit_app.py or pages\nif __name__ == \"__main__\":\n    main()\n\n# GOOD - just put the code directly\nimport streamlit as st\n\nst.title(\"My App\")\n```\n\nThe main guard is fine in utility modules for quick testing:\n\n```python\n# utils\u002Fdata.py\ndef load_data(path):\n    ...\n\n# Optional: test this module directly with `python utils\u002Fdata.py`\nif __name__ == \"__main__\":\n    print(load_data(\"test.csv\"))\n```\n\n## References\n\n- [Multipage apps](https:\u002F\u002Fdocs.streamlit.io\u002Fdevelop\u002Fconcepts\u002Fmultipage-apps)\n- [st.cache_data](https:\u002F\u002Fdocs.streamlit.io\u002Fdevelop\u002Fapi-reference\u002Fcaching-and-state\u002Fst.cache_data)\n","# Streamlit code organization\n\nFor most simple apps, keep everything in one file—it's cleaner and more straightforward. The app file should read like a normal Python script for data processing, with a few Streamlit commands sprinkled in.\n\nName the main file `streamlit_app.py` (Streamlit's default).\n\n## When to split\n\n**Keep in one file (most apps):**\n- Apps under ~1000 lines\n- One-off scripts and prototypes\n- Apps where logic is straightforward\n\n**Consider splitting when:**\n- Data processing is complex (50+ lines of non-UI code)\n- Multiple pages share logic\n- You want to test business logic separately\n\nIf splitting makes sense, here's how to organize it.\n\n## Directory structure\n\n```\nmy-app\u002F\n├── streamlit_app.py      # Main entry point\n├── app_pages\u002F            # Page UI modules\n│   ├── dashboard.py\n│   └── settings.py\n└── utils\u002F                # Business logic & helpers\n    ├── data.py\n    └── api.py\n```\n\n## Separating UI from logic\n\nWhen you do split, keep Streamlit files focused on UI and move complex logic to utility modules:\n\n```python\n# streamlit_app.py - UI-focused\nimport streamlit as st\nfrom utils.data import load_sales_data, compute_metrics\n\nst.title(\"Sales Dashboard\")\n\nstart = st.date_input(\"Start\")\nend = st.date_input(\"End\")\n\ndata = load_sales_data(start, end)\nmetrics = compute_metrics(data)\n\nst.metric(\"Revenue\", f\"${metrics['revenue']:,.0f}\")\nst.dataframe(data)\n```\n\n## Avoid if __name__ == \"__main__\"\n\nStreamlit apps run the entire file on each interaction. Don't use the main guard in Streamlit files.\n\n```python\n# BAD - don't do this in streamlit_app.py or pages\nif __name__ == \"__main__\":\n    main()\n\n# GOOD - just put the code directly\nimport streamlit as st\n\nst.title(\"My App\")\n```\n\nThe main guard is fine in utility modules for quick testing:\n\n```python\n# utils\u002Fdata.py\ndef load_data(path):\n    ...\n\n# Optional: test this module directly with `python utils\u002Fdata.py`\nif __name__ == \"__main__\":\n    print(load_data(\"test.csv\"))\n```\n\n## References\n\n- [Multipage apps](https:\u002F\u002Fdocs.streamlit.io\u002Fdevelop\u002Fconcepts\u002Fmultipage-apps)\n- [st.cache_data](https:\u002F\u002Fdocs.streamlit.io\u002Fdevelop\u002Fapi-reference\u002Fcaching-and-state\u002Fst.cache_data)\n",{"name":5,"license":15,"description":7},"main","3efae68c898153694a2f4aad309c7ff9847b5602","installed-skills\u002Fdeveloping-with-streamlit\u002Fskills\u002Forganizing-streamlit-code",0,"https:\u002F\u002Fgithub.com\u002Flegout\u002Fpi-config","https:\u002F\u002Fgithub.com\u002Flegout","2026-04-28 16:32:33",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":64},[54,57,60],{"tool":55,"command":56},"npx","npx skills add legout\u002Fpi-config --skill organizing-streamlit-code",{"tool":58,"command":59},"bunx","bunx skills add legout\u002Fpi-config --skill organizing-streamlit-code",{"tool":61,"command":62},"pnpm","pnpm dlx skills add legout\u002Fpi-config --skill organizing-streamlit-code","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flegout\u002Fpi-config\u002Fblob\u002Fmain\u002Finstalled-skills\u002Fdeveloping-with-streamlit\u002Fskills\u002Forganizing-streamlit-code\u002FSKILL.md",true,[],[67,101,129,144,162,182],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":71,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":82,"publishedAt":40},"01M6KGW7MYKZ8MWFKN1V8ZJ2EG","visual-explainer","Generate beautiful, self-contained HTML pages that visually explain systems, code changes, plans, and data. Use when the user asks for a diagram, architecture overview, diff review, plan review, project recap, comparison table, or any visual explanation of technical concepts. Also use proactively when you are about to render a complex ASCII table (4+ rows or 3+ columns) — present it as a styled HTML page instead.","MIT","https:\u002F\u002Fgithub.com\u002Flegout\u002Fpi-config\u002Fblob\u002Fmain\u002Fskills\u002Fvisual-explainer\u002FSKILL.md",[74,79],{"categoryNo":75,"categoryName":76,"taxonomyType":77,"taxonomyTypeDesc":78},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",{"categoryNo":80,"categoryName":81,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000033","数据分析师",[83,84,85,86,87,88,89,90,91,28,92,93,94,95,96,97,98,99,100,39],"visual explainer","explainer","visual","image","architecture","generate","plan","table","view","files","project","present","as","ascii table","ascii","you","concepts","surf",{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":71,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":113,"publishedAt":40},"01M6KGTMTJR6RXXC8AF29MQQW5","table-extractor",">","https:\u002F\u002Fgithub.com\u002Flegout\u002Fpi-config\u002Fblob\u002Fmain\u002Finstalled-skills\u002Ftable-extractor\u002FSKILL.md",[107,110],{"categoryNo":108,"categoryName":109,"taxonomyType":77,"taxonomyTypeDesc":78},"01JBSEEDCAT000000000000002","文档处理",{"categoryNo":111,"categoryName":112,"taxonomyType":77,"taxonomyTypeDesc":78},"01JBSEEDCAT000000000000023","Skill与智能体开发",[90,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128],"table extractor","PDF","MCP","gpt","extraction","office","data","parsing","extract","en","zh","camelot","sonnet","opus","tables",{"skillNo":130,"name":131,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":71,"licenseFileUrl":6,"sourceHtmlUrl":132,"categories":133,"keywords":136,"publishedAt":40},"01M6KGSWF2R22Z63PAY5NT6GRY","smart-ocr","https:\u002F\u002Fgithub.com\u002Flegout\u002Fpi-config\u002Fblob\u002Fmain\u002Finstalled-skills\u002Fsmart-ocr\u002FSKILL.md",[134,135],{"categoryNo":108,"categoryName":109,"taxonomyType":77,"taxonomyTypeDesc":78},{"categoryNo":111,"categoryName":112,"taxonomyType":77,"taxonomyTypeDesc":78},[137,138,115,116,139,117,118,119,121,140,122,123,124,141,142,126,127,143],"ocr","smart ocr","support","text","multilingual","processing","paddleocr",{"skillNo":145,"name":146,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":71,"licenseFileUrl":6,"sourceHtmlUrl":147,"categories":148,"keywords":154,"publishedAt":40},"01M6KGMKKFNC1PRNX2W3E243DR","html-slides","https:\u002F\u002Fgithub.com\u002Flegout\u002Fpi-config\u002Fblob\u002Fmain\u002Finstalled-skills\u002Fhtml-slides\u002FSKILL.md",[149,152,153],{"categoryNo":150,"categoryName":151,"taxonomyType":77,"taxonomyTypeDesc":78},"01JBSEEDCAT000000000000003","演示文稿",{"categoryNo":75,"categoryName":76,"taxonomyType":77,"taxonomyTypeDesc":78},{"categoryNo":111,"categoryName":112,"taxonomyType":77,"taxonomyTypeDesc":78},[155,156,157,158,116,159,117,119,123,124,160,161,126,127],"slides","html","html slides","pptx","web","revealjs","presentation",{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":166,"categories":167,"keywords":168,"publishedAt":40},"01M6KGJGVM0TWW632Y6VQQV2WN","using-streamlit-session-state","Using st.session_state to manage state across Streamlit reruns. Use when persisting data, handling widget state, implementing callbacks, or debugging state issues. Covers initialization patterns, widget-state association, and common gotchas.","https:\u002F\u002Fgithub.com\u002Flegout\u002Fpi-config\u002Fblob\u002Fmain\u002Finstalled-skills\u002Fdeveloping-with-streamlit\u002Fskills\u002Fusing-streamlit-session-state\u002FSKILL.md",[],[169,170,25,171,172,173,174,120,175,28,176,31,177,178,179,180,181],"state","session","session state","using streamlit session state","debugging","issues","common","manage","across","widget","Callbacks","implementing","initialization",{"skillNo":183,"name":184,"nameZh":6,"description":185,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":186,"categories":187,"keywords":189,"publishedAt":40},"01M6KGJD12GJB7W0ZG66JK00F6","using-streamlit-markdown","Covers all Markdown features in Streamlit including GitHub-flavored syntax plus Streamlit extensions like colored text, badges, Material icons, and LaTeX. Use when formatting text, labels, tooltips, or any text-rendering element.","https:\u002F\u002Fgithub.com\u002Flegout\u002Fpi-config\u002Fblob\u002Fmain\u002Finstalled-skills\u002Fdeveloping-with-streamlit\u002Fskills\u002Fusing-streamlit-markdown\u002FSKILL.md",[188],{"categoryNo":108,"categoryName":109,"taxonomyType":77,"taxonomyTypeDesc":78},[190,25,191,192,193,194,140,195,28,196,197,198,199,200,201,202],"markdown","using streamlit markdown","github","icons","LaTeX","syntax","formatting","element","material","rendering","extensions","features","labels"]