CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

principle-foundational-thinking

Apply before writing logic: choosing core types and data structures, sequencing scaffold-vs-feature work, asking what concurrent actors share. Get the data structures right so downstream code becomes obvious.

62

Quality

78%

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 ./plugins/pstack/skills/principle-foundational-thinking/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 content is a tight, well-organized set of actionable design principles with a clearly stated ordering, appropriately contained in a single short file. Its only real weakness is a brief passage of programming wisdom Claude already knows and the absence of a worked example that would make the principles fully concrete.

DimensionReasoningScore

Conciseness

The body is lean (~250 words) with no padding, but the DRY paragraph ("Three similar statements still beat a premature abstraction. Prefer explicit over clever. Test behavior and edge cases, not line counts.") restates programming wisdom Claude already knows, matching anchor 4 for minor instances of over-explanation rather than 5.

4 / 5

Actionability

Concrete, executable heuristics are given ("Define core types early, trace every access pattern", "ask 'what happens if another actor modifies this concurrently?' If not 'nothing', isolate", "does every subsequent phase benefit from this existing?"); as an instruction-only skill the absence of code is not penalized, but no worked examples are provided, matching anchor 4 rather than 5.

4 / 5

Workflow Clarity

The decision sequence is explicit and coherent ("Subtraction comes before scaffolding", "setup before features, tests before fixes", data structures before logic); there are no destructive or batch operations so no validation cap applies, but there is no explicit tie-breaking guidance when principles conflict, matching anchor 4.

4 / 5

Progressive Disclosure

The body is ~20 lines, well under 50, with no need for external references (none are referenced and no bundle files exist); the bolded lead-ins (**Data structures first.**, **Concurrency corollary.**, **Scaffold first.**) delineate clear sections, so per the short-skill guideline it qualifies for the full score.

5 / 5

Total

17

/

20

Passed

Description

67%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 does and when to apply it, with a distinct niche and several specific named actions. Its main weakness is trigger-term phrasing that leans on internal jargon rather than the natural language a user would use when asking for this kind of guidance.

Suggestions

Add a natural-language trigger clause naming user-side phrasings, e.g. "Use when designing data models, deciding what to build first, or before introducing an abstraction".

Include common synonyms for the key concepts ("data model", "schema", "shared state") so the description matches how users actually describe these situations.

DimensionReasoningScore

Specificity

"choosing core types and data structures, sequencing scaffold-vs-feature work, asking what concurrent actors share" lists three specific actions within the design domain, matching the anchor for several specific actions with minor gaps in coverage; it falls short of 5 because coverage is not comprehensive and the phrasing stays somewhat abstract.

4 / 5

Completeness

Both what ("Get the data structures right so downstream code becomes obvious") and when ("Apply before writing logic" plus three trigger situations) are present, so the missing-'Use when' cap at 3 does not apply since equivalent explicit trigger guidance exists; the when could be more explicit and use more concrete trigger phrases, matching anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Relevant keywords exist ("core types", "data structures", "scaffold", "concurrent") but the phrasing is jargon-leaning ("scaffold-vs-feature work", "concurrent actors") and misses natural variations users would actually say ("data model", "schema design", "when to abstract"), matching the anchor for some relevant keywords missing common synonyms; not 4 because keyword coverage is not broad enough.

3 / 5

Distinctiveness Conflict Risk

The foundational-design niche (data-shape-first, scaffold sequencing, concurrency isolation) is clearly distinguishable from most skills with only minor overlap risk against general refactoring or architecture-principle skills, matching anchor 4; not 5 because the domain still broadly applies to all coding work.

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

adamsardo/pstack-claude

Path

plugins/pstack/skills/principle-foundational-thinking/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.