agentleFS
tomekdottomekdot/hermes-skills/skills/software-development/my-frontend-starter/SKILL.md

my-frontend-starter

Skill1 starsChanged 5 months agoMITView on GitHub

My Frontend — Angular 19 SPA starter with Material Design, Docker, and nginx. Use when working on the my-frontend project (KUL-2023-API/src/labs/lab10/my-frontend).

  • Installs packages

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Add standalone: false to all components

    line 92
  2. Distinctive:

    All 4 routes render correctly

    line 99
  3. Distinctive:

    No browser console errors

    line 101

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

My Frontend Starter

Project Overview

Angular 19 LTS SPA with Angular Material, served via nginx in Docker.

Location: src/labs/lab10/my-frontend/

Quick Start

cd src/labs/lab10/my-frontend

# Docker (recommended)
docker compose up --build
# → http://localhost:4200

# Without Docker
npm install
npm start
# → http://localhost:4200

Project Structure

src/
├── app/
│   ├── app.component          # Root: toolbar + router-outlet
│   ├── app.module.ts          # Root NgModule (all components declared here)
│   ├── app-routing.module.ts  # All routes defined here
│   ├── users/                 # /users — user list from API
│   ├── comments/              # /comments — comments from API
│   ├── rest/                  # /rest — API demo page
│   └── rest.service.ts        # HTTP service (providedIn: 'root')
├── gallery/
│   ├── gallery.module.ts      # Feature module
│   └── gallery.component      # /gallery — image gallery
└── main.ts                    # Bootstrap

Routes

PathComponentData Source
/usersUsersComponentJSONPlaceholder /users
/commentsCommentsComponentJSONPlaceholder /comments
/galleryGalleryComponentpicsum.photos
/restRestComponentStatic placeholder

Key Conventions

  • All components use standalone: false (NgModule pattern)
  • All routes in AppRoutingModule (no forChild in feature modules)
  • All Material modules imported in AppModule
  • Typed API responses — User[], Comment[], no any
  • API base: https://jsonplaceholder.typicode.com

Docker

CommandDescription
docker compose up --buildBuild + run
docker compose downStop
docker compose logs -fLogs

Multi-stage: Node 22 (build) → nginx Alpine (~50MB).

Common Issues

IssueFix
NG6008: Component is standaloneAdd standalone: false to @Component
TS2792: Cannot find module '@angular/core'Set moduleResolution: "bundler" in tsconfig
TS2307: Cannot find module 'rxjs'npm install rxjs@7.8.1
NG2003: No suitable injection tokenAdd @Injectable({ providedIn: 'root' })
Gallery route redirects to /usersMove route from GalleryModule.forChild to AppRoutingModule
Dependabot alerts for tar, picomatch, tmpDev dependencies only — not in Docker image

Updating Angular

Safe path: 16 → 17 → 19 LTS. Don't jump to 22 (requires TS 6.x, new build system).

After updating:

  1. Delete node_modules + package-lock.json
  2. npm install
  3. Add standalone: false to all components
  4. Set moduleResolution: "bundler" in tsconfig
  5. ng build --configuration development

Verification

  1. ng build --configuration development — 0 errors
  2. All 4 routes render correctly
  3. API calls return 200
  4. No browser console errors

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.