CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

copilot-instructions-blueprint-generator

Technology-agnostic blueprint generator for creating comprehensive copilot-instructions.md files that guide GitHub Copilot to produce code consistent with project standards, architecture patterns, and exact technology versions by analyzing existing codebase patterns and avoiding assumptions.

1.40x
Quality

62%

Does it follow best practices?

Impact

91%

1.40x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/copilot-instructions-blueprint-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill body delivers a complete, parameterized prompt template, but as a SKILL.md it is a monolith: heavily repetitive inline template text, template conditionals instead of concrete output examples, and zero use of bundle files. It would benefit most from splitting the per-technology template library into reference files and adding verification steps.

Suggestions

Move the per-technology (.NET/Java/JS/React/Angular/Python) and per-focus (quality/documentation/testing) template blocks into references/ files (e.g., references/dotnet.md, references/testing.md) and keep SKILL.md as a short overview pointing to them one level deep.

Deduplicate the near-identical 'follow existing patterns in the codebase' bullets — state the principle once and let each section list only its genuinely section-specific items, cutting token load by more than half.

Add a validation step to the workflow, e.g. 'After generating, verify every stated version against package.json/.csproj/pom.xml and confirm each referenced pattern exists in a real file before delivering', with a fix-and-retry loop.

DimensionReasoningScore

Conciseness

The ~250-line inlined template repeats the same instruction ('Follow existing/matching patterns found in the codebase') in nearly every bullet across the Quality, Documentation, Testing, and Technology sections — noticeably padded with no new information per repetition. Not a 1 because it never explains concepts Claude already knows; not a 3 because the redundancy is pervasive rather than incidental.

2 / 5

Actionability

The deliverable is concrete in intent (a full prompt template with config variables and placement in .github/copilot), but the ${...}-conditional blocks are pseudocode-like template expressions rather than executable or copy-paste-ready material, and no example of a finished copilot-instructions.md is given. Fits the 'some concrete guidance but incomplete / pseudocode' anchor better than anchor 4.

3 / 5

Workflow Clarity

An implicit sequence exists (set variables → analyze codebase → fill template → emit file to .github/copilot) and the analysis steps are enumerated, but there are no validation checkpoints — e.g., nothing instructs verifying detected versions against package.json/.csproj or reviewing the generated file against actual codebase patterns. Not a 2 because the sequence and steps are reasonably well defined.

3 / 5

Progressive Disclosure

There are no references/, scripts/, or assets/ files — the entire per-technology and per-quality-focus template library is inlined in one 290-line SKILL.md. Content that clearly belongs in separate reference files (e.g., per-language guidelines) is fully inlined with no navigation, matching the anchor 2 example of inlined bulk content. Not a 3 because there are no references or external structure at all to signal.

2 / 5

Total

10

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly communicates what the skill produces and its niche, with mostly natural trigger keywords, but it is a single dense sentence that omits any 'when to use' guidance. Adding an explicit trigger clause and trimming abstract padding would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to create or improve a copilot-instructions.md file, set up GitHub Copilot for a repository, or asks for Copilot configuration/custom instructions.'

Include natural synonyms users would say — 'Copilot setup', 'custom instructions', 'coding guidelines' — to widen trigger coverage without adding length.

Remove abstract padding like 'avoiding assumptions' and 'Technology-agnostic blueprint generator for' in favor of a plainer verb-first statement of the concrete actions.

DimensionReasoningScore

Specificity

Names several concrete actions ('creating comprehensive copilot-instructions.md files', 'analyzing existing codebase patterns', 'produce code consistent with ... exact technology versions') but pads them with abstract qualifiers like 'avoiding assumptions'. Not a 5 because coverage gaps and fluffy phrasing remain; not a 3 because it clearly lists more than 1-2 specific actions.

4 / 5

Completeness

The 'what' is clear (a blueprint generator for copilot-instructions.md files), but the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not a 4 because nothing even weakly implies when to use it; not a 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

Includes strong natural keywords users would say ('copilot-instructions.md', 'GitHub Copilot', 'project standards', 'architecture patterns') but misses common variations like 'Copilot setup', 'custom instructions', or 'coding guidelines'. Fits the 'good keyword coverage, a few natural terms missing' anchor better than either neighbor.

4 / 5

Distinctiveness Conflict Risk

Names a distinct niche (generating copilot-instructions.md for GitHub Copilot) that most skills would not trigger on, with only minor overlap risk against codebase-analysis or coding-standards skills. Not a 5 because generic terms like 'project standards' and 'architecture patterns' could pull in adjacent skills.

4 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

github/awesome-copilot

Path

skills/copilot-instructions-blueprint-generator/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.