CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sdlc-explore-ideas

Systematic codebase exploration, architectural critique, and generation of Project Discovery Drafts for SDLC Phase 0.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/sdlc-explore-ideas/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 body delivers a genuinely actionable, well-sequenced exploration workflow with a concrete output template and clear handoff boundaries. Its main weaknesses are token waste from the persona theatrics and duplicated directives, plus small template defects (mis-numbered section header) and the absence of any error-recovery guidance.

Suggestions

Deduplicate: collapse Core Directives 3/4/5 into Phases 4/5 and merge the Anti-Patterns section with the DO/DON'T lists, cutting roughly 20% of the body.

Replace the "CRITICAL SYSTEM OVERRIDE" theatrics and activation-key ritual with 2-3 plain lines defining the Senior Staff Engineer stance.

Fix the Mandatory Template's section numbering ("## ⚙️ Operational Workflow" should be "## 4. ...") and add a brief recovery path for when exploration is insufficient or the user rejects the draft.

DimensionReasoningScore

Conciseness

The bulk of the body is tight, instructional prose (bold directives, concrete paths), but there is real waste: the theatrical persona-override framing ("THIS IS A CORE IDENTITY OVERRIDE. YOU ARE HEREBY COMMANDED..."), the session-lock ritual, and directives stated twice — Core Directives 3/4/5 duplicate Phases 4/5, and the Anti-Patterns repeat the DON'Ts. This fits anchor 3 (mostly efficient, could be tightened) better than anchor 2, since the padding is redundancy rather than explanation of known concepts.

3 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: a fill-in-the-blank Mandatory Template, exact file-naming conventions (docs/discovery-draft-YYYYMMDD-HHMM-[name].md), a verbatim refusal message, a ready-to-use handoff prompt, and the ADR Triple Gate checklist. Minor gaps keep it from anchor 5: the template has a broken section header ("## ⚙️ Operational Workflow" where "## 4." should be, with numbering jumping to "## 5."), and a few directives like "Engage in a back-and-forth dialogue" stay abstract.

4 / 5

Workflow Clarity

Phases 1-5 are clearly sequenced (reconnaissance → critique → brainstorming → draft generation → handoff) with user-approval checkpoints at draft generation and handoff, plus the Triple Gate validation for ADRs. It misses anchor 5 because there are no error-recovery/feedback loops (e.g., how to handle an incomplete exploration or a rejected draft), only happy-path gating.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ all absent), so this scores the single-file structure: clear section headers, and external pointers (docs/ARCHITECTURE.md, .agents/standards/CONTEXT-FORMAT.md, ADR-FORMAT.md, sibling sdlc skills) are clearly signaled and one level deep. Not anchor 5 because at ~176 lines the Mandatory Template and Documentation Standards are inlined where a references/ file would keep the overview leaner; not anchor 3 since nothing is buried and the structure is coherent.

4 / 5

Total

15

/

20

Passed

Description

58%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 communicates a clear, moderately specific capability set with a distinctive niche artifact, but it completely lacks a 'when to use' trigger clause and relies on framework jargon ("SDLC Phase 0") rather than natural user language. It is serviceable but would materially improve with explicit trigger guidance.

Suggestions

Add an explicit 'Use when...' clause, e.g., "Use when onboarding to an unfamiliar codebase, tracing a bug's structural origin, brainstorming refactoring, or before writing a PRD for a legacy project."

Include natural trigger phrases and synonyms users would actually say ("explore this codebase", "understand this project", "architecture review", "tech debt assessment") rather than only framework terms like "SDLC Phase 0".

Mention the interactive brainstorming/handoff role so the capability coverage matches what the skill actually does.

DimensionReasoningScore

Specificity

The description lists three concrete actions — "Systematic codebase exploration, architectural critique, and generation of Project Discovery Drafts" — which goes beyond the 1-2 actions of anchor 3. It falls short of anchor 5 because coverage is not comprehensive: the body also covers interactive brainstorming and PRD handoff, which the description omits.

4 / 5

Completeness

The "what" is clear (exploration, critique, discovery draft generation) but there is no "Use when..." clause or equivalent trigger guidance; "for SDLC Phase 0" only weakly implies timing. Per the rubric guideline, a missing 'when' clause caps completeness at 3, and the explicit-when of anchor 4/5 is absent.

3 / 5

Trigger Term Quality

Relevant keywords like "codebase exploration" and "architectural critique" are present, but natural user phrasings ("explore this codebase", "understand this project", "onboarding", "tech debt", "before writing a PRD") are missing, and "SDLC Phase 0" is framework jargon a user would rarely say. This matches anchor 3 (some relevant keywords, missing common variations) rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

"Project Discovery Drafts for SDLC Phase 0" carves a clear niche with a distinct artifact, giving minimal conflict with unrelated skills. It is not a 5 because "codebase exploration" and "architectural critique" overlap with closely related skills in the same SDLC suite (e.g., sdlc-map-architecture) and with generic code-review skills.

4 / 5

Total

14

/

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

glenrioariesto/social-content-studio

Path

.agents/skills/sdlc-explore-ideas/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.