{"id":"35fd30e1-11b4-44a5-8ba6-3eb98b2a9944","shortId":"48zAtu","kind":"skill","title":"jup-architect","tagline":"Use when analyzing the jup codebase, identifying technical debt, suggesting architectural improvements, or ensuring high engineering standards.","description":"# jup Expert Architect Assistant 🏗️\n\nThis skill helps AI agents analyze the `jup` codebase, identify technical debt, suggest architectural improvements, and ensure high engineering standards.\n\n## How to Use This Skill\n\n- **Codebase Analysis**: Perform deep dives into `src/jup/` to understand current implementation patterns.\n- **Technical Debt Audit**: Identify areas where the code is fragile, complex, or difficult to test.\n- **Architectural Proposals**: Suggest structural changes to improve modularity, performance, or scalability.\n- **Code Quality Review**: Evaluate existing code against best practices for Python, Typer, and Pydantic.\n\n## Core Architectural Values\n\n- **Modularity**: Maintain clear boundaries between CLI commands (`commands/`), configuration (`config.py`), and data models (`models.py`). Commands should focus on CLI interaction, while logic should be extracted to utilities or models where possible.\n- **Idiomatic Typer**: Leverage Typer's `Context` for state management and shared services. Avoid global state where possible. Use `verbose_state` sparingly.\n- **Type Safety**: Use Pydantic v2 for all data models and configuration. Leverage Python 3.12+ type hints throughout.\n- **Robust Error Handling**: Replace `print` with structured logging or custom exceptions when appropriate. Ensure the CLI fails gracefully with helpful error messages and non-zero exit codes.\n- **Testability**: Prioritize designs that are easy to unit test. Use `unittest.mock` to isolate dependencies in tests.\n\n## Key Areas of Focus\n\n- **Command Orchestration**: Evaluate how commands are registered and executed. Ensure the `commands/` package is easy to extend.\n- **Data Persistence**: Analyze how `~/.jup` and the lockfile are managed. Ensure the lockfile schema is stable and migration-friendly.\n- **Dependency Management**: Review the use of `uv` and external libraries. Minimize unnecessary dependencies.\n- **Testing Strategy**: Suggest improvements to the current `pytest` suite and coverage.\n\n## Process Flow\n\n```dot\ndigraph architect_flow {\n    \"Deep dive src/jup/\" [shape=box];\n    \"Identify tech debt/bottlenecks\" [shape=box];\n    \"Propose improvements\" [shape=box];\n    \"Align with jup values?\" [shape=diamond];\n    \"Refine proposal\" [shape=box];\n    \"Create architectural spec\" [shape=box];\n\n    \"Deep dive src/jup/\" -> \"Identify tech debt/bottlenecks\";\n    \"Identify tech debt/bottlenecks\" -> \"Propose improvements\";\n    \"Propose improvements\" -> \"Align with jup values?\";\n    \"Align with jup values?\" -> \"Refine proposal\" [label=\"no\"];\n    \"Refine proposal\" -> \"Align with jup values?\";\n    \"Align with jup values?\" -> \"Create architectural spec\" [label=\"yes\"];\n}\n```\n\n## Deliverables\n\n- **Architectural Specs**: Detailed specifications for structural changes in `docs/superpowers/specs/`.\n- **Refactoring Plans**: Implementation plans for cleaning up technical debt in `docs/superpowers/plans/`.\n- **Code Quality Reports**: Summaries of findings and recommendations.","tags":["jup","architect","andrader","agent","agent-skills","agentic-ai","agents","ai-agents","cli","installer","manager","skills"],"capabilities":["skill","source-andrader","skill-jup-architect","topic-agent","topic-agent-skills","topic-agentic-ai","topic-agents","topic-ai-agents","topic-cli","topic-installer","topic-manager","topic-skills"],"categories":["jup"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/andrader/jup/jup-architect","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add andrader/jup","source_repo":"https://github.com/andrader/jup","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 10 github stars · SKILL.md body (2,990 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T07:03:32.552Z","embedding":null,"createdAt":"2026-04-23T13:04:10.655Z","updatedAt":"2026-04-24T07:03:32.552Z","lastSeenAt":"2026-04-24T07:03:32.552Z","tsv":"'/.jup':243 '3.12':170 'agent':29 'ai':28 'align':303,331,335,345,349 'analysi':51 'analyz':6,30,241 'appropri':186 'architect':3,23,287 'architectur':14,38,77,103,314,354,359 'area':66,219 'assist':24 'audit':64 'avoid':148 'best':95 'boundari':108 'box':293,298,302,312,317 'chang':81,365 'clean':373 'clear':107 'cli':110,123,189 'code':69,88,93,201,379 'codebas':9,33,50 'command':111,112,119,222,226,233 'complex':72 'config.py':114 'configur':113,167 'context':141 'core':102 'coverag':282 'creat':313,353 'current':59,278 'custom':183 'data':116,164,239 'debt':12,36,63,376 'debt/bottlenecks':296,323,326 'deep':53,289,318 'deliver':358 'depend':215,259,271 'design':204 'detail':361 'diamond':308 'difficult':74 'digraph':286 'dive':54,290,319 'docs/superpowers/plans':378 'docs/superpowers/specs':367 'dot':285 'easi':207,236 'engin':19,43 'ensur':17,41,187,231,249 'error':175,194 'evalu':91,224 'except':184 'execut':230 'exist':92 'exit':200 'expert':22 'extend':238 'extern':267 'extract':129 'fail':190 'find':384 'flow':284,288 'focus':121,221 'fragil':71 'friend':258 'global':149 'grace':191 'handl':176 'help':27,193 'high':18,42 'hint':172 'identifi':10,34,65,294,321,324 'idiomat':136 'implement':60,370 'improv':15,39,83,275,300,328,330 'interact':124 'isol':214 'jup':2,8,21,32,305,333,337,347,351 'jup-architect':1 'key':218 'label':341,356 'leverag':138,168 'librari':268 'lockfil':246,251 'log':181 'logic':126 'maintain':106 'manag':144,248,260 'messag':195 'migrat':257 'migration-friend':256 'minim':269 'model':117,133,165 'models.py':118 'modular':84,105 'non':198 'non-zero':197 'orchestr':223 'packag':234 'pattern':61 'perform':52,85 'persist':240 'plan':369,371 'possibl':135,152 'practic':96 'print':178 'priorit':203 'process':283 'propos':78,299,310,327,329,340,344 'pydant':101,160 'pytest':279 'python':98,169 'qualiti':89,380 'recommend':386 'refactor':368 'refin':309,339,343 'regist':228 'replac':177 'report':381 'review':90,261 'robust':174 'safeti':158 'scalabl':87 'schema':252 'servic':147 'shape':292,297,301,307,311,316 'share':146 'skill':26,49 'skill-jup-architect' 'source-andrader' 'spare':156 'spec':315,355,360 'specif':362 'src/jup':56,291,320 'stabl':254 'standard':20,44 'state':143,150,155 'strategi':273 'structur':80,180,364 'suggest':13,37,79,274 'suit':280 'summari':382 'tech':295,322,325 'technic':11,35,62,375 'test':76,210,217,272 'testabl':202 'throughout':173 'topic-agent' 'topic-agent-skills' 'topic-agentic-ai' 'topic-agents' 'topic-ai-agents' 'topic-cli' 'topic-installer' 'topic-manager' 'topic-skills' 'type':157,171 'typer':99,137,139 'understand':58 'unit':209 'unittest.mock':212 'unnecessari':270 'use':4,47,153,159,211,263 'util':131 'uv':265 'v2':161 'valu':104,306,334,338,348,352 'verbos':154 'yes':357 'zero':199","prices":[{"id":"cf1136ed-bc7e-4c0e-ba0d-f3c17beb3c44","listingId":"35fd30e1-11b4-44a5-8ba6-3eb98b2a9944","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"andrader","category":"jup","install_from":"skills.sh"},"createdAt":"2026-04-23T13:04:10.655Z"}],"sources":[{"listingId":"35fd30e1-11b4-44a5-8ba6-3eb98b2a9944","source":"github","sourceId":"andrader/jup/jup-architect","sourceUrl":"https://github.com/andrader/jup/tree/main/skills/jup-architect","isPrimary":false,"firstSeenAt":"2026-04-23T13:04:10.655Z","lastSeenAt":"2026-04-24T07:03:32.552Z"}],"details":{"listingId":"35fd30e1-11b4-44a5-8ba6-3eb98b2a9944","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"andrader","slug":"jup-architect","github":{"repo":"andrader/jup","stars":10,"topics":["agent","agent-skills","agentic-ai","agents","ai","ai-agents","cli","installer","manager","skills"],"license":null,"html_url":"https://github.com/andrader/jup","pushed_at":"2026-04-24T03:07:45Z","description":"jup is a command-line tool for installing and managing agent skills across different ai agents, scopes, and projects.","skill_md_sha":"562191cb81906e6ae2ab2aac729f5a7091842b23","skill_md_path":"skills/jup-architect/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/andrader/jup/tree/main/skills/jup-architect"},"layout":"multi","source":"github","category":"jup","frontmatter":{"name":"jup-architect","description":"Use when analyzing the jup codebase, identifying technical debt, suggesting architectural improvements, or ensuring high engineering standards."},"skills_sh_url":"https://skills.sh/andrader/jup/jup-architect"},"updatedAt":"2026-04-24T07:03:32.552Z"}}