# nishant-tiwari24/cracked architecture

> Architecture diagram of the GitHub repository nishant-tiwari24/cracked, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nishant-tiwari24/cracked
- Repository: https://github.com/nishant-tiwari24/cracked

## Overview

cracked is a collection of agent skills for interview and job-placement preparation, with a companion website for browsing skills and searching company interview data. The README describes the main learner workflow: install the pack, set up a profile, then use an agent for interview practice, resume feedback, or company-specific preparation. The tree exposes only a few skill scripts, not the skill definitions themselves, so the graph shows documented capabilities without guessing their implementation links; the repeated shop APIs are evaluation resources, not the product.

Main entry points: [`website/src/app/page.tsx`](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/app/page.tsx) (Skills Website), [`website/src/app/skills/[slug]/page.tsx`](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/app/skills/%5Bslug%5D/page.tsx) (Skill Pages), [`website/src/components/company-search.tsx`](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/components/company-search.tsx) (Company Search), [`website/src/lib/skills.ts`](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/lib/skills.ts) (Skill Catalog Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Skills Website"]
  node_website["Skills Website<br/>[page.tsx]"]
  node_skill_pages["Skill Pages<br/>[page.tsx]"]
  node_company_search["Company Search<br/>[company-search.tsx]"]
  node_site_data["Skill Catalog Data<br/>[skills.ts]"]
  node_site_shell["Site Shell<br/>[shell.tsx]"]
  node_client_controls["Page Controls<br/>[client.tsx]"]
end

subgraph group_prep["Interview Preparation"]
  node_company_intel["Company Intelligence<br/>[questions.py]"]
  node_mock_interviews["Mock Interviews"]
  node_oa_sim["Online Assessment"]
  node_design_hr["Design and HR Rounds"]
end

subgraph group_career["Career Tools"]
  node_setup["Profile Setup"]
  node_resume_review["Resume Review"]
  node_job_match["Job Description Match"]
  node_project_defense["Project Defense"]
  node_project_upgrade["Project Upgrade"]
  node_github_glowup["GitHub Glowup<br/>[image-to-ascii.py]"]
  node_offer_decode["Offer Decoder<br/>[ctc.py]"]
end

node_learner(("Learner"))
node_agent(("AI Coding Agent"))

node_learner -->|"browses skills"| node_website
node_website -->|"uses catalog"| node_site_data
node_website -->|"offers search"| node_company_search
node_learner -->|"opens skill"| node_skill_pages
node_skill_pages -->|"renders within"| node_site_shell
node_skill_pages -.->|"offers controls"| node_client_controls
node_learner -->|"installs and prompts"| node_agent
node_agent -->|"runs setup"| node_setup
node_setup -->|"builds briefs"| node_company_intel
node_agent -->|"runs interview"| node_mock_interviews
node_agent -->|"runs assessment"| node_oa_sim
node_agent -->|"runs rounds"| node_design_hr
node_agent -->|"reviews resume"| node_resume_review
node_agent -->|"matches job"| node_job_match
node_agent -->|"defends project"| node_project_defense
node_agent -->|"improves project"| node_project_upgrade
node_agent -.->|"runs skill"| node_github_glowup
node_agent -.->|"runs skill"| node_offer_decode

click node_website "https://github.com/nishant-tiwari24/cracked/blob/main/website/src/app/page.tsx"
click node_skill_pages "https://github.com/nishant-tiwari24/cracked/blob/main/website/src/app/skills/%5Bslug%5D/page.tsx"
click node_company_search "https://github.com/nishant-tiwari24/cracked/blob/main/website/src/components/company-search.tsx"
click node_site_data "https://github.com/nishant-tiwari24/cracked/blob/main/website/src/lib/skills.ts"
click node_site_shell "https://github.com/nishant-tiwari24/cracked/blob/main/website/src/components/shell.tsx"
click node_client_controls "https://github.com/nishant-tiwari24/cracked/blob/main/website/src/components/client.tsx"
click node_company_intel "https://github.com/nishant-tiwari24/cracked/blob/main/skills/core/company-intel/scripts/questions.py"
click node_github_glowup "https://github.com/nishant-tiwari24/cracked/blob/main/skills/profile/github-glowup/scripts/image-to-ascii.py"
click node_offer_decode "https://github.com/nishant-tiwari24/cracked/blob/main/skills/strategy/offer-decode/scripts/ctc.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_website,node_skill_pages,node_company_search,node_site_data,node_site_shell,node_client_controls toneBlue
class node_company_intel,node_mock_interviews,node_oa_sim,node_design_hr toneAmber
class node_setup,node_resume_review,node_job_match,node_project_defense,node_project_upgrade,node_github_glowup,node_offer_decode toneMint
class node_learner,node_agent toneIndigo
```

## Components

### Skills Website

- [Skills Website](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/app/page.tsx): `website/src/app/page.tsx`
- [Skill Pages](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/app/skills/%5Bslug%5D/page.tsx): `website/src/app/skills/[slug]/page.tsx`
- [Company Search](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/components/company-search.tsx): `website/src/components/company-search.tsx`
- [Skill Catalog Data](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/lib/skills.ts): `website/src/lib/skills.ts`
- [Site Shell](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/components/shell.tsx): `website/src/components/shell.tsx`
- [Page Controls](https://github.com/nishant-tiwari24/cracked/blob/main/website/src/components/client.tsx): `website/src/components/client.tsx`

### Interview Preparation

- [Company Intelligence](https://github.com/nishant-tiwari24/cracked/blob/main/skills/core/company-intel/scripts/questions.py): `skills/core/company-intel/scripts/questions.py`
- **Mock Interviews**
- **Online Assessment**
- **Design and HR Rounds**

### Career Tools

- **Profile Setup**
- **Resume Review**
- **Job Description Match**
- **Project Defense**
- **Project Upgrade**
- [GitHub Glowup](https://github.com/nishant-tiwari24/cracked/blob/main/skills/profile/github-glowup/scripts/image-to-ascii.py): `skills/profile/github-glowup/scripts/image-to-ascii.py`
- [Offer Decoder](https://github.com/nishant-tiwari24/cracked/blob/main/skills/strategy/offer-decode/scripts/ctc.py): `skills/strategy/offer-decode/scripts/ctc.py`

### Other components

- **Learner**
- **AI Coding Agent**

## Connections

- Learner → Skills Website: browses skills (evidence: `README.md`)
- Skills Website → Skill Catalog Data: uses catalog (evidence: `website/src/app/page.tsx`)
- Skills Website → Company Search: offers search (evidence: `README.md`)
- Learner → Skill Pages: opens skill (evidence: `README.md`)
- Skill Pages → Site Shell: renders within (evidence: `website/src/components/shell.tsx`)
- Skill Pages → Page Controls: offers controls
- Learner → AI Coding Agent: installs and prompts (evidence: `README.md`)
- AI Coding Agent → Profile Setup: runs setup (evidence: `README.md`)
- Profile Setup → Company Intelligence: builds briefs (evidence: `README.md`)
- AI Coding Agent → Mock Interviews: runs interview (evidence: `README.md`)
- AI Coding Agent → Online Assessment: runs assessment (evidence: `README.md`)
- AI Coding Agent → Design and HR Rounds: runs rounds (evidence: `README.md`)
- AI Coding Agent → Resume Review: reviews resume (evidence: `README.md`)
- AI Coding Agent → Job Description Match: matches job (evidence: `README.md`)
- AI Coding Agent → Project Defense: defends project (evidence: `README.md`)
- AI Coding Agent → Project Upgrade: improves project (evidence: `README.md`)
- AI Coding Agent → GitHub Glowup: runs skill
- AI Coding Agent → Offer Decoder: runs skill
