Skip to content

Commit cd7007b

Browse files
author
Test
committed
docs(skills): add skill layout, fix navigation, reorder tools by relevance
- Created skill.html layout extending default (skill pages now have nav) - Renamed section to 'Using Skills in Other Tools' - Reordered tools by relevance: Cursor, Copilot, Antigravity, Gemini, Claude, Replit - Added 'strongest support' note for Cursor
1 parent aa3bbbd commit cd7007b

2 files changed

Lines changed: 103 additions & 38 deletions

File tree

docs/_layouts/skill.html

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
layout: default
3+
---
4+
5+
<style>
6+
.skill-header {
7+
margin-bottom: 2rem;
8+
padding-bottom: 1rem;
9+
border-bottom: 1px solid var(--color-border, #3b4261);
10+
}
11+
12+
.skill-meta {
13+
display: flex;
14+
gap: 1rem;
15+
flex-wrap: wrap;
16+
margin-bottom: 1rem;
17+
}
18+
19+
.skill-badge {
20+
background: var(--color-card-bg, #16161e);
21+
border: 1px solid var(--color-border, #3b4261);
22+
padding: 0.25rem 0.75rem;
23+
border-radius: 16px;
24+
font-size: 0.85rem;
25+
color: var(--color-text-secondary);
26+
}
27+
28+
.skill-badge.language {
29+
border-color: #7aa2f7;
30+
color: #7aa2f7;
31+
}
32+
33+
.back-link {
34+
display: inline-block;
35+
margin-bottom: 1.5rem;
36+
color: #7aa2f7;
37+
text-decoration: none;
38+
font-size: 0.9rem;
39+
}
40+
41+
.back-link:hover {
42+
text-decoration: underline;
43+
}
44+
</style>
45+
46+
<a href="{{ '/skills' | relative_url }}" class="back-link">← Back to Skills</a>
47+
48+
<article class="skill-content">
49+
<header class="skill-header">
50+
<h1>{{ page.title }}</h1>
51+
<div class="skill-meta">
52+
{% if page.language %}
53+
<span class="skill-badge language">{{ page.language }}</span>
54+
{% endif %}
55+
{% if page.category %}
56+
<span class="skill-badge">{{ page.category }}</span>
57+
{% endif %}
58+
</div>
59+
{% if page.description %}
60+
<p>{{ page.description }}</p>
61+
{% endif %}
62+
</header>
63+
64+
{{ content }}
65+
</article>

docs/skills.md

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -108,10 +108,25 @@ Want to add a skill for your favorite language? [Open a PR](https://github.com/g
108108

109109
---
110110

111-
## Using gt Skills in Other Tools
111+
## Using Skills in Other Tools
112112

113113
The skills that power `gt` can also be used in other AI coding tools. Here's how to apply them in your favorite environment:
114114

115+
### Cursor
116+
117+
Cursor has the **strongest support** for project rules via `.cursorrules`:
118+
119+
```bash
120+
# Export skills directly to Cursor format
121+
gt skills show go > .cursorrules
122+
123+
# Or combine multiple skills
124+
gt skills show go >> .cursorrules
125+
gt skills show tdd-bug-fix >> .cursorrules
126+
```
127+
128+
Cursor reads `.cursorrules` automatically and applies them to **every** interaction—no need to ask.
129+
115130
### VS Code (GitHub Copilot)
116131

117132
GitHub Copilot supports custom instructions via files in your project:
@@ -132,34 +147,24 @@ gt skills show tdd-bug-fix > .github/prompts/tdd.prompt.md
132147

133148
Use in Copilot Chat by referencing the prompt.
134149

135-
### Cursor
136-
137-
Cursor has strong support for project rules via `.cursorrules`:
150+
### Antigravity (Gemini in IDE)
138151

139-
```bash
140-
# Export skills directly to Cursor format
141-
gt skills show go > .cursorrules
152+
If you're using Google's Antigravity (Gemini IDE integration):
142153

143-
# Or combine multiple skills
144-
gt skills show go >> .cursorrules
145-
gt skills show tdd-bug-fix >> .cursorrules
154+
1. Create `.gemini/settings.json` in your project:
155+
```json
156+
{
157+
"customInstructions": "See .gemini/skills/ for coding guidelines"
158+
}
146159
```
147160

148-
Cursor reads `.cursorrules` automatically and applies them to **every** interaction—no need to ask.
149-
150-
### Replit (Agent / Ghostwriter)
151-
152-
Replit doesn't auto-load rule files yet, but you can use a convention:
153-
161+
2. Export skills to `.gemini/skills/`:
154162
```bash
155-
# Export to a RULES file
156-
gt skills show python > RULES.md
163+
mkdir -p .gemini/skills
164+
gt skills show python > .gemini/skills/python.md
165+
gt skills show tdd-bug-fix > .gemini/skills/tdd.md
157166
```
158167

159-
**Tips for Replit:**
160-
1. Keep `RULES.md` **open in an editor tab**—Ghostwriter prioritizes open files
161-
2. When using Replit Agent, start with: *"Read RULES.md and follow strictly"*
162-
163168
### Google Gemini (AI Studio / API)
164169

165170
For Gemini, use skills as system instructions:
@@ -208,36 +213,31 @@ message = client.messages.create(
208213
)
209214
```
210215

211-
### Antigravity (Gemini in IDE)
212-
213-
If you're using Google's Antigravity (Gemini IDE integration):
216+
### Replit (Agent / Ghostwriter)
214217

215-
1. Create `.gemini/settings.json` in your project:
216-
```json
217-
{
218-
"customInstructions": "See .gemini/skills/ for coding guidelines"
219-
}
220-
```
218+
Replit doesn't auto-load rule files yet, but you can use a convention:
221219

222-
2. Export skills to `.gemini/skills/`:
223220
```bash
224-
mkdir -p .gemini/skills
225-
gt skills show python > .gemini/skills/python.md
226-
gt skills show tdd-bug-fix > .gemini/skills/tdd.md
221+
# Export to a RULES file
222+
gt skills show python > RULES.md
227223
```
228224

225+
**Tips for Replit:**
226+
1. Keep `RULES.md` **open in an editor tab**—Ghostwriter prioritizes open files
227+
2. When using Replit Agent, start with: *"Read RULES.md and follow strictly"*
228+
229229
---
230230

231231
## Quick Reference
232232

233233
| Tool | Config Location | Auto-loaded? |
234234
|------|-----------------|--------------|
235235
| **gt** | Built-in | ✅ Yes |
236-
| **VS Code Copilot** | `.github/copilot-instructions.md` | ✅ Yes |
237236
| **Cursor** | `.cursorrules` | ✅ Yes (strong) |
238-
| **Replit** | `RULES.md` (convention) | ❌ Manual |
237+
| **VS Code Copilot** | `.github/copilot-instructions.md` | ✅ Yes |
238+
| **Antigravity** | `.gemini/skills/` | ⚡ Partial |
239239
| **Gemini** | System instruction | ❌ Manual |
240240
| **Claude** | System prompt | ❌ Manual |
241-
| **Antigravity** | `.gemini/skills/` | ⚡ Partial |
241+
| **Replit** | `RULES.md` (convention) | ❌ Manual |
242242

243243
> 💡 **Pro tip**: Commit your skills files to git so your whole team benefits from consistent AI-generated code!

0 commit comments

Comments
 (0)