Skip navigation
system-atlas: a skill that builds an explorable isometric map of your codebase / agent / pipeline…
0:00 / 0:35

system-atlas: a skill that builds an explorable isometric map of your codebase / agent / pipeline…

harsh

@GarshytHoel2.6K followers

Visit on X
1,857 likesDownloadOriginal post

167,064 views

system-atlas: a skill that builds an explorable isometric map of your codebase / agent / pipeline from one data file arranging the system visually does something for my brain that a wall of text doesn't i've found it way more useful to build up understanding of a system or a large change through these progressive disclosure style atlases than through docs. hover to read, click to pin, step inside a box to watch it run, click a packet to see the actual payload. chapters reveal the system a few boxes at a time instead of all at once. the md twin is generated from the same file so it can't drift works from both sides. - building a new architecture and moving pieces around visually before anything is written - pointed it at a 67 pr stack (don't ask how i got there) and finally understood how the thing fit together it also keeps track of every open question in the system. as you clarify or improve things the answers land in the atlas, so "wait did we decide that" has an answer instead of a scroll through slack.

38 Comments

Comments from the original post on X (Twitter)

  • harsh's profile picture

    @GarshytHoel

    `npx skills add inkboard/system-atlas`

    103 likes

  • Justin Reidy's profile picture

    @VegetablesReidy

    This is dope thanks for sharing. We’re increasingly using these kinds of visual support skills at No Diet (initially soured by @humanlayer_dev’s show me skill). Seeing really helps my understanding.

    3 likes

  • harsh's profile picture

    @GarshytHoel

    @humanlayer_dev 100% - i've been trying recently to read the code again but honestly w/ the pace at which these things sling code it's a losing battle. so at least understanding the basic topology is the minimum. Kind of ironic that we're all back to being eng managers again 😂

    3 likes

  • wesley⚡️'s profile picture

    @wesleymagness

    ELITE - our team gave it a go and are going to keep using your work. congrats. we did find a lil issue in the HTML template if you want to check it out:

    2 likes

  • harsh's profile picture

    @GarshytHoel

    Tysm! I’ll take a look

    1 like

  • wesley⚡️'s profile picture

    @wesleymagness

    worked out really well fwiw

    1 like

  • Fried Bun's profile picture

    @Suge_dif

    Inspiration from this

    2 likes

  • Matija Sosic's profile picture

    @MatijaSosic

    love it! we're working on something similar for Wasp, but it's coming from the compile-time spec. Will be applying much nicer color theme to it though :)

    2 likes

  • Henry Mascot's profile picture

    @iAmHenryMascot

    wicked!

    2 likes

  • harsh's profile picture

    @GarshytHoel

    thanks!

  • Matthew Bilo's profile picture

    @matthewpsbilo

    Super cool! Curious how you simulated the data flows? Did you just give examples yourself or is that from a live local dev server?

    2 likes

  • harsh's profile picture

    @GarshytHoel

    The agent executing the skill picks it up from it’s explorations

    2 likes

  • symbols's profile picture

    @symbolsrsymbols

    @deepok102

    2 likes

  • L’Écho du Corbeau's profile picture

    @provaxscience

    I love it

    1 like

  • Stefan's profile picture

    @builtbystef

    This is very, very cool. I tried building something broadly similar to this but found the diagrams the agents made weren’t entirely accurate. Do you find this skill to be accurate enough?

    1 like

  • harsh's profile picture

    @GarshytHoel

    At least works on the scales that I’ve been testing with. Not sure how it’ll perform at bugger scales

  • maz's profile picture

    @mmazco

    love this! how did you give the visual animation?

    1 like

  • harsh's profile picture

    @GarshytHoel

    just claude doing claude things :)

  • Yel's profile picture

    @yel_420

    Please change the name. Everyone I work with has some kind of 'atlas' or 'vortex' or 'forge' and they all do different things. Don't go with the AI naming, for all of our sakes.

    1 like

  • harsh's profile picture

    @GarshytHoel

    i think it might be a little too late now 😅 - i agree w/ you though

    4 likes