Skip to content

Commit 86bbc94

Browse files
MarkTechsonatscott
authored andcommitted
docs: add agent skills documentation and new readme
1 parent 9d79ec6 commit 86bbc94

File tree

4 files changed

+58
-4
lines changed

4 files changed

+58
-4
lines changed

adev/src/app/routing/navigation-entries/index.ts

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -875,7 +875,6 @@ export const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
875875
},
876876
{
877877
label: 'Build with AI',
878-
status: 'new',
879878
children: [
880879
{
881880
label: 'Get Started',
@@ -888,9 +887,10 @@ export const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
888887
contentPath: 'ai/develop-with-ai',
889888
},
890889
{
891-
label: 'Design Patterns',
892-
path: 'ai/design-patterns',
893-
contentPath: 'ai/design-patterns',
890+
label: 'Agent Skills',
891+
path: 'ai/agent-skills',
892+
contentPath: 'ai/agent-skills',
893+
status: 'new',
894894
},
895895
{
896896
label: 'Angular CLI MCP Server setup',
@@ -902,6 +902,11 @@ export const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
902902
path: 'ai/ai-tutor',
903903
contentPath: 'ai/ai-tutor',
904904
},
905+
{
906+
label: 'Design Patterns',
907+
path: 'ai/design-patterns',
908+
contentPath: 'ai/design-patterns',
909+
},
905910
],
906911
},
907912
{
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Agent Skills
2+
3+
Agent Skills are specialized, domain-specific instructions and capabilities designed for AI agents like Gemini CLI. These skills provide architectural guidance, generate idiomatic Angular code, and help scaffold new projects using modern best practices.
4+
5+
By using Agent Skills, you can ensure that the AI agent you are working with has the most up-to-date information about Angular's conventions, reactivity models (like Signals), and project structure.
6+
7+
## Available Skills
8+
9+
The Angular team maintains a collection of official skills that are regularly updated to stay in sync with the latest framework improvements.
10+
11+
| Skill | Description |
12+
| :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
13+
| **`angular-developer`** | Generates Angular code and provides architectural guidance. Useful for creating components, services, or obtaining best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling, testing, or CLI tooling. |
14+
| **`angular-new-app`** | Creates a new Angular app using the Angular CLI. Provides important guidelines for effectively setting up and structuring a modern Angular application. |
15+
16+
## Using Agent Skills
17+
18+
Agent Skills are designed to be used with agentic coding tools like [Gemini CLI](https://geminicli.com/docs/cli/skills/), [Antigravity](https://antigravity.google/docs/skills) and more. Activating a skill loads the specific instructions and resources needed for that task.
19+
20+
To use these skills in your own environment you may follow the instructions for your specific tool or use a community tool like [skills.sh](https://skills.sh/).
21+
22+
```bash
23+
npx skills add https://github.com/angular/skills
24+
```

adev/src/content/ai/overview.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -115,4 +115,5 @@ To learn about LLM prompts and AI IDE setup, see the following guides:
115115

116116
<docs-pill-row>
117117
<docs-pill href="ai/develop-with-ai" title="LLM prompts and IDE setup"/>
118+
<docs-pill href="ai/agent-skills" title="Agent Skills"/>
118119
</docs-pill-row>

skills/dev-skills/README.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Angular Skills
2+
3+
The Angular skills are designed to help coding agents create applications aligned with the latest versions of Angular, best practices, new features and manage Angular applications effectively. These skills provide architectural guidance, generate idiomatic Angular code, and help scaffold new projects using modern best practices.
4+
5+
## Available Skills
6+
7+
- **`angular-developer`**: Generates Angular code and provides architectural guidance. Useful for creating components, services, or obtaining best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling, testing, or CLI tooling.
8+
- **`angular-new-app`**: Creates a new Angular app using the Angular CLI. Provides important guidelines for effectively setting up and structuring a modern Angular application.
9+
10+
## Contributions
11+
12+
We welcome contributions to the Angular agent skills. If you would like to contribute to the skills, please make the updates directly in `angular/angular` repository, and to that repository will be output here as a part of our infrastructure setup.
13+
14+
### Feedback & Issues
15+
16+
If you encounter a bug, have feedback, or want to suggest an improvement to the skills, please file an issue in the [angular/angular](https://github.com/angular/angular/issues/new?template=3-docs-bug.yaml) issue tracker. Providing detailed context will help us address your feedback effectively.
17+
18+
### Features & Changes (Pull Requests)
19+
20+
We also accept pull requests for new features, updates, or bug fixes for the skills:
21+
22+
1. Make your changes within the `skills/dev-skills/` directory.
23+
2. Follow the standard Angular [Commit Guidelines](https://github.com/angular/angular/blob/main/contributing-docs/commit-message-guidelines.md) and [Coding Standards](https://github.com/angular/angular/blob/main/contributing-docs/coding-standards.md).
24+
3. Submit a Pull Request to the main `angular/angular` repository.

0 commit comments

Comments
 (0)