Skip to content

feat: generate skills to workspace root with composable naming and YAML frontmatter #775

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pyramation merged 4 commits into from
Mar 4, 2026
Merged

feat: generate skills to workspace root with composable naming and YAML frontmatter #775

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
3224805
feat: generate skills to workspace root with composable naming and YA…
pyramation Mar 4, 2026
138c4e2
fix: pass targetName to skill generator functions in tests and update…
pyramation Mar 4, 2026
fdeb909
fix: restore docs.skills toggle for generated skills
pyramation Mar 4, 2026
7ab07f1
chore: remove automatic deletion of old nested skill directories
pyramation Mar 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
161 changes: 133 additions & 28 deletions graphql/codegen/src/__tests__/codegen/__snapshots__/cli-generator.test.ts.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -362,7 +362,12 @@ No developer or entity involved in creating this software will be liable for any
`;

exports[`cli docs generator generates CLI skill files 1`] = `
"# myapp-context
"---
name: cli-context
description: Manage API endpoint contexts for myapp
---

# cli-context

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -396,7 +401,12 @@ myapp context list
`;

exports[`cli docs generator generates CLI skill files 2`] = `
"# myapp-auth
"---
name: cli-auth
description: Manage authentication tokens for myapp
---

# cli-auth

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -427,7 +437,12 @@ myapp auth status
`;

exports[`cli docs generator generates CLI skill files 3`] = `
"# myapp-car
"---
name: cli-default-car
description: CRUD operations for Car records via myapp CLI
---

# cli-default-car

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -478,7 +493,12 @@ myapp car delete --id <value>
`;

exports[`cli docs generator generates CLI skill files 4`] = `
"# myapp-driver
"---
name: cli-default-driver
description: CRUD operations for Driver records via myapp CLI
---

# cli-default-driver

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -529,7 +549,12 @@ myapp driver delete --id <value>
`;

exports[`cli docs generator generates CLI skill files 5`] = `
"# myapp-current-user
"---
name: cli-default-current-user
description: Get the currently authenticated user
---

# cli-default-current-user

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand All @@ -552,7 +577,12 @@ myapp current-user
`;

exports[`cli docs generator generates CLI skill files 6`] = `
"# myapp-login
"---
name: cli-default-login
description: Authenticate a user
---

# cli-default-login

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -1781,7 +1811,12 @@ No developer or entity involved in creating this software will be liable for any
`;

exports[`hooks docs generator generates hooks skill files 1`] = `
"# hooks-car
"---
name: hooks-default-car
description: React Query hooks for Car data operations
---

# hooks-default-car

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -1819,7 +1854,12 @@ mutate({ make: '<value>', model: '<value>', year: '<value>', isElectric: '<value
`;

exports[`hooks docs generator generates hooks skill files 2`] = `
"# hooks-driver
"---
name: hooks-default-driver
description: React Query hooks for Driver data operations
---

# hooks-default-driver

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -1857,7 +1897,12 @@ mutate({ name: '<value>', licenseNumber: '<value>' });
`;

exports[`hooks docs generator generates hooks skill files 3`] = `
"# hooks-currentUser
"---
name: hooks-default-current-user
description: Get the currently authenticated user
---

# hooks-default-current-user

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand All @@ -1880,7 +1925,12 @@ const { data, isLoading } = useCurrentUserQuery();
`;

exports[`hooks docs generator generates hooks skill files 4`] = `
"# hooks-login
"---
name: hooks-default-login
description: Authenticate a user
---

# hooks-default-login

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -2905,7 +2955,12 @@ No developer or entity involved in creating this software will be liable for any
exports[`multi-target cli docs generates multi-target skills 1`] = `
[
{
"content": "# myapp-context
"content": "---
name: cli-context
description: Manage API endpoint contexts for myapp (multi-target: auth, members, app)
---

# cli-context

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -2944,10 +2999,15 @@ myapp context list
myapp context use staging
\`\`\`
",
"fileName": "skills/context.md",
"fileName": "cli-context/SKILL.md",
},
{
"content": "# myapp-credentials
"content": "---
name: cli-auth
description: Manage authentication tokens for myapp (shared across all targets)
---

# cli-auth

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -2975,10 +3035,15 @@ myapp credentials set-token eyJhbGciOiJIUzI1NiIs...
myapp credentials status
\`\`\`
",
"fileName": "skills/credentials.md",
"fileName": "cli-auth/SKILL.md",
},
{
"content": "# myapp-auth:user
"content": "---
name: cli-auth-user
description: CRUD operations for User records via myapp CLI (auth target)
---

# cli-auth-user

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -3014,10 +3079,15 @@ myapp auth:user create --email "value" --name "value"
myapp auth:user get --id <value>
\`\`\`
",
"fileName": "skills/auth-user.md",
"fileName": "cli-auth-user/SKILL.md",
},
{
"content": "# myapp-auth:current-user
"content": "---
name: cli-auth-current-user
description: Get the currently authenticated user (auth target)
---

# cli-auth-current-user

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand All @@ -3037,10 +3107,15 @@ myapp auth:current-user
myapp auth:current-user
\`\`\`
",
"fileName": "skills/auth-current-user.md",
"fileName": "cli-auth-current-user/SKILL.md",
},
{
"content": "# myapp-auth:login
"content": "---
name: cli-auth-login
description: Authenticate a user (auth target)
---

# cli-auth-login

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand All @@ -3061,10 +3136,15 @@ myapp auth:login --email <value> --password <value> --save-token
myapp auth:login --email <value> --password <value>
\`\`\`
",
"fileName": "skills/auth-login.md",
"fileName": "cli-auth-login/SKILL.md",
},
{
"content": "# myapp-members:member
"content": "---
name: cli-members-member
description: CRUD operations for Member records via myapp CLI (members target)
---

# cli-members-member

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -3100,10 +3180,15 @@ myapp members:member create --role "value"
myapp members:member get --id <value>
\`\`\`
",
"fileName": "skills/members-member.md",
"fileName": "cli-members-member/SKILL.md",
},
{
"content": "# myapp-app:car
"content": "---
name: cli-app-car
description: CRUD operations for Car records via myapp CLI (app target)
---

# cli-app-car

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -3139,7 +3224,7 @@ myapp app:car create --make "value" --model "value" --year "value" --isElectric
myapp app:car get --id <value>
\`\`\`
",
"fileName": "skills/app-car.md",
"fileName": "cli-app-car/SKILL.md",
},
]
`;
Expand Down Expand Up @@ -4502,7 +4587,12 @@ No developer or entity involved in creating this software will be liable for any
`;

exports[`orm docs generator generates ORM skill files 1`] = `
"# orm-car
"---
name: orm-default-car
description: ORM operations for Car records
---

# orm-default-car

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -4540,7 +4630,12 @@ const item = await db.car.create({
`;

exports[`orm docs generator generates ORM skill files 2`] = `
"# orm-driver
"---
name: orm-default-driver
description: ORM operations for Driver records
---

# orm-default-driver

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down Expand Up @@ -4578,7 +4673,12 @@ const item = await db.driver.create({
`;

exports[`orm docs generator generates ORM skill files 3`] = `
"# orm-currentUser
"---
name: orm-default-current-user
description: Get the currently authenticated user
---

# orm-default-current-user

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand All @@ -4601,7 +4701,12 @@ const result = await db.query.currentUser().execute();
`;

exports[`orm docs generator generates ORM skill files 4`] = `
"# orm-login
"---
name: orm-default-login
description: Authenticate a user
---

# orm-default-login

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Expand Down
6 changes: 3 additions & 3 deletions graphql/codegen/src/__tests__/codegen/cli-generator.test.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -285,7 +285,7 @@ describe('cli docs generator', () => {
});

it('generates CLI skill files', () => {
const skills = generateCliSkills([carTable, driverTable], allCustomOps, 'myapp');
const skills = generateCliSkills([carTable, driverTable], allCustomOps, 'myapp', 'default');
expect(skills.length).toBeGreaterThan(0);
for (const sf of skills) {
expect(sf.content).toMatchSnapshot();
Expand Down Expand Up @@ -317,7 +317,7 @@ describe('orm docs generator', () => {
});

it('generates ORM skill files', () => {
const skills = generateOrmSkills([carTable, driverTable], allCustomOps);
const skills = generateOrmSkills([carTable, driverTable], allCustomOps, 'default');
expect(skills.length).toBeGreaterThan(0);
for (const sf of skills) {
expect(sf.content).toMatchSnapshot();
Expand Down Expand Up @@ -349,7 +349,7 @@ describe('hooks docs generator', () => {
});

it('generates hooks skill files', () => {
const skills = generateHooksSkills([carTable, driverTable], allCustomOps);
const skills = generateHooksSkills([carTable, driverTable], allCustomOps, 'default');
expect(skills.length).toBeGreaterThan(0);
for (const sf of skills) {
expect(sf.content).toMatchSnapshot();
Expand Down
Loading