oberconcejo/VS-CODE / .agents/skills/angular-developer
angular-developer
VerifiedGenerates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.
references/cli.md
View on GitHub# Angular CLI Guide for Agents
The Angular CLI (`ng`) is the primary tool for managing an Angular workspace. Always prefer CLI commands over manual file creation or generic `npm` commands when modifying project structure or adding Angular-specific dependencies.
## 1. Managing Dependencies
**ALWAYS use `ng add` for Angular libraries** instead of `npm install`. `ng add` installs the package AND runs initialization schematics (e.g., configuring `angular.json`, updating root providers).
```bash
ng add @angular/material
ng add tailwindcss
ng add @angular/fire
```
To update the application and its dependencies (which automatically runs code migrations):
```bash
ng update @angular/core@<latest or specific version> @angular/cli<latest or specific version>
```
## 2. Generating Code (`ng generate` or `ng g`)
Always use the CLI to generate code to ensure it adheres to Angular standards and updates necessary configuration files automatically.
| Target | Command | Notes |
| :----------- | :-------------------- | :--------------------------------------------------------------------------------------------- |
| Component | `ng g c path/to/name` | Generates a component. Use `--inline-style` (`-s`) or `--inline-template` (`-t`) if requested. |
| Service | `ng g s path/to/name` | Generates an `@Injectable({providedIn: 'root'})` service. |
| Directive | `ng g d path/to/name` | Generates a directive. |
| Pipe | `ng g p path/to/name` | Generates a pipe. |
| Guard | `ng g g path/to/name` | Generates a functional route guard. |
| Environments | `ng g environments` | Scaffolds `src/environments/` and updates `angular.json` with file replacements. |
_Note: There is no command to generate a single route definition. Generate a component, then manually add it to the `Routes` array in `app.routes.ts`._
## 3. Development Server & Proxying
Start the local development server with hot-module replacement (HMR):
```bash
ng serve
```
### Backend API Proxying
To proxy API requests during development (e.g., rerouting `/api` to a local Node server):
1. Create `src/proxy.conf.json`:
```json
{
"/api/**": {"target": "http://localhost:3000", "secure": false}
}
```
2. Update `angular.json` under the `serve` target:
```json
"serve": {
"builder": "@angular/build:dev-server",
"options": { "proxyConfig": "src/proxy.conf.json" }
}
```
## 4. Building the Application
Compile the application into an output directory (default: `dist/<project-name>/browser`). Modern Angular uses the `@angular/build:application` builder (esbuild-based).
```bash
ng build
```
- `ng build` defaults to the production configuration, which enables Ahead-of-Time (AOT) compilation, minification, and tree-shaking.
- Target specific configurations defined in `angular.json` using `--configuration`: `ng build --configuration=staging`.
## 5. Testing
- **Unit Tests**: Run `ng test` to execute unit tests via the configured test runner (e.g., Karma or Vitest).
- **End-to-End (E2E)**: Run `ng e2e`. If no E2E framework is configured, the CLI will prompt to install one (Cypress, Playwright, Puppeteer, etc.).
## 6. Deployment
To deploy an application, you must first add a deployment builder, then run the deploy command:
```bash
# Example for Firebase
ng add @angular/fire
ng deploy
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |