P

Principal Engineer OS

yourakshaw/principal-engineer-os · unreleased source · d6434cf · Agent Skills

by YourAKShawOwner verifiedScan grade: Good

Agent skill that guides AI-assisted engineering with explicit trade-offs, boundary-focused correctness, security and privacy review, operational judgment, and evidence-based delivery

InstallSource
Follow0
Trust Score77Security scan86Components1

Is Principal Engineer OS a fit?

From the plugin's manifest and HOL's scan. Anything the plugin does not declare is shown as not declared.

Works with

  • Agent Skills
  • 1 skill

Before you install

Sign-in
Not declared
Declared access
Not declared
License
Not declared

Check before relying on it

  • Some security checks did not finish: Cisco skill scan. See the evidence
  • No license declared in the manifest.

What is Principal Engineer OS?

Principal Engineer OS is a published agent skills plugin for AI coding agents in the agent-skills ecosystem, developed by YourAKShaw and distributed through the HOL AI plugin registry. Agent skill that guides AI-assisted engineering with explicit trade-offs, boundary-focused correctness, security and privacy review, operational judgment, and evidence-based delivery

Canonical slug
yourakshaw/principal-engineer-os
Version
unreleased source · d6434cf · updated Oct 27, 2026

Trust & reputation

77

HOL Trust Score

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
100/100
Maintenance
65/100
MCP server setup
100/100
Plugin Security
86/100
Provenance
70/100
Publisher Quality
75/100

Registry Snapshot

Owner verification
Verified on HOL as @YourAKShaw
Marketplace source
Unknown
Scanner
HOL plugin scanner
Security result
Needs review
Digest verified
Yes
1 bundled skillRead, copy or download each SKILL.mdOpen skills

Trust & reputation

Trust & reputation

77

HOL Trust Score

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
100/100
Maintenance
65/100
MCP server setup
100/100
Plugin Security
86/100
Provenance
70/100
Publisher Quality
75/100

Provenance

Plugin root
.
Source repo
https://github.com/YourAKShaw/principal-engineer-os
Source commit
d6434cf098a1…
Publisher verified
No
Owner verified
@YourAKShaw
Agent Plugins 1.0
Not detected

Continuous scanner CI not detected

This plugin remains listed. Its overall trust score is reduced by 10% because security checks are not maintained in the source repository's CI.

Optional: maintain the scanner in the source repository's CI to receive the full trust score. Listing does not require that change.

README badge detected

The source repository README links to this HOL listing. Distribution, not security evidence. It adds a 2% engagement adjustment to the overall trust score and never changes the security result.

Security Posture

See how the Trust Score is computed
Needs review
Security result
86
Security score
0
High findings
Provider
codex-plugin-scanner
Grade
B · Good
Version
3.24.2
cisco-skill-scanner: failedcisco-mcp-scanner: skipped

Manifest Validation

21/31

9 checks

Security

16/16

9 checks

Operational Security

17/17

5 checks

Best Practices

9/12

5 checks

Marketplace

N/A

3 checks · not applicable

Skill Security

5/5

4 checks

Code Quality

10/10

2 checks

Findings

infomanifest-validationPLUGIN_JSON_RECOMMENDED_AUTHOR

The manifest is missing the documented recommended field "author".

Add "author" to strengthen the plugin manifest metadata.

infomanifest-validationPLUGIN_JSON_RECOMMENDED_LICENSE

The manifest is missing the documented recommended field "license".

Add "license" to strengthen the plugin manifest metadata.

infomanifest-validationPLUGIN_JSON_RECOMMENDED_KEYWORDS

The manifest is missing the documented recommended field "keywords".

Add "keywords" to strengthen the plugin manifest metadata.

infomanifest-validationPLUGIN_JSON_INTERFACE_SHORTDESCRIPTION

The interface object is missing a valid "shortDescription" value.

Add a valid "shortDescription" field to the interface metadata.

infomanifest-validationPLUGIN_JSON_INTERFACE_LONGDESCRIPTION

The interface object is missing a valid "longDescription" value.

Add a valid "longDescription" field to the interface metadata.

infomanifest-validationPLUGIN_JSON_INTERFACE_CAPABILITIES

The interface object is missing a valid "capabilities" value.

Add a valid "capabilities" field to the interface metadata.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_WEBSITEURL

The interface field "websiteURL" must use HTTPS or point to a safe in-repo asset.

Update "websiteURL" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_PRIVACYPOLICYURL

The interface field "privacyPolicyURL" must use HTTPS or point to a safe in-repo asset.

Update "privacyPolicyURL" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_TERMSOFSERVICEURL

The interface field "termsOfServiceURL" must use HTTPS or point to a safe in-repo asset.

Update "termsOfServiceURL" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_COMPOSERICON

The interface field "composerIcon" must use HTTPS or point to a safe in-repo asset.

Update "composerIcon" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_LOGO

The interface field "logo" must use HTTPS or point to a safe in-repo asset.

Update "logo" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_SCREENSHOTS

The interface field "screenshots" must use HTTPS or point to a safe in-repo asset.

Update "screenshots" to use HTTPS or an existing relative asset path.

infobest-practicesCODEXIGNORE_MISSING

A .codexignore file helps prevent accidental inclusion of local artifacts and secrets.

Add a .codexignore file with generated assets, local state, and secret paths.

Principal Engineer OS — Frequently asked questions

What is Principal Engineer OS?
Principal Engineer OS is an AI plugin in the HOL registry. Agent skill that guides AI-assisted engineering with explicit trade-offs, boundary-focused correctness, security and privacy review, operational judgment, and evidence-based delivery
How do I install Principal Engineer OS?
Install Principal Engineer OS in your harness: Source — https://github.com/YourAKShaw/principal-engineer-os/releases; Any agent — npx [email protected] add YourAKShaw/principal-engineer-os. Full step-by-step guidance is on the HOL plugin page.
How do I install Principal Engineer OS in Source?
To install Principal Engineer OS in Source, start with https://github.com/YourAKShaw/principal-engineer-os/releases. The complete step-by-step install guide for Source is on the HOL plugin page.
Is Principal Engineer OS free?
Pricing for Principal Engineer OS is published on its HOL plugin page when the maker schedules a launch.
How is the Trust Score for Principal Engineer OS computed?
Principal Engineer OS has a HOL Trust Score of 77 out of 100. The score is a weighted sum of six components from a static scan of the source, capped for high-severity findings and adjusted by two disclosed policies. Memberships and payments are not inputs, and a scan is not a safety guarantee. Full breakdown: https://hol.org/registry/plugins/yourakshaw%2Fprincipal-engineer-os/trust
Who publishes Principal Engineer OS?
Principal Engineer OS is published by YourAKShaw and listed on HOL.
Is Principal Engineer OS available now?
Principal Engineer OS availability is listed on its HOL plugin page.

Install Guidance

Install in Source

Install from a native release archive or the assessed source revision.

Install guide
  1. 1

    Download the release archive

    Use a published GitHub release archive. The catalog version is the package version at the assessed commit.

    shell
  2. 2

    Follow the publisher install guide

    https://github.com/YourAKShaw/principal-engineer-os/blob/d6434cf098a1e0c99c9acac26c7eab3c3a7a590f/docs/INSTALL.md

Did setup work in Source?

No setup reports for Source yet. Self-reported by signed-in visitors. Copying a command is not counted, and most installs are never reported.

Attested installs: Fewer than 10 attested installs of this plugin in week 2026-W43, so no number is shown. Counted from opt-in HOL Guard install reports, once per machine and runtime, and never mixed with the answers above. How install reports work.

Loading reviews

Plugin Manifest

{
  "name": "principal-engineer-os",
  "version": "0.0.0",
  "description": "Agent skill that guides AI-assisted engineering with explicit trade-offs, boundary-focused correctness, security and privacy review, operational judgment, and evidence-based delivery",
  "repository": "https://github.com/YourAKShaw/principal-engineer-os",
  "homepage": "https://github.com/YourAKShaw/principal-engineer-os",
  "interface": {
    "displayName": "Principal Engineer OS",
    "developerName": "YourAKShaw",
    "category": "Agent Skills"
  },
  "skills": "./",
  "holManifestOrigin": "synthesized",
  "registryIndexVersion": 8
}

Skills

1 SKILL.md file ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

Share
skills-cli

  • principal-engineer-os

    SKILL.md

    Apply principal-engineer judgment to software design, implementation, code review, debugging, refactoring, migrations, and production readiness. Use for engineering work that needs explicit correctness, security, reliability, or architectural trade-offs; scale the process down for small changes.

    Raw SKILL.md

File Inventory

.codex-plugin/plugin.json

plugin-manifest

561 bytes

e71fe285303b604d…

.github/CONTRIBUTING.md

file

5,505 bytes

163bca7147570189…

.github/dependabot.yml

file

170 bytes

ff7bbaa3fb4662c2…

.github/ISSUE_TEMPLATE/01-bug-report.yml

file

1,404 bytes

7d6253a58559fac7…

.github/ISSUE_TEMPLATE/02-improvement.yml

file

1,174 bytes

345ecc1727cb34fb…

.github/ISSUE_TEMPLATE/03-documentation.yml

file

634 bytes

b6f6dbd051919d85…

.github/ISSUE_TEMPLATE/config.yml

file

246 bytes

c92a4bf3d293146a…

.github/pull_request_template.md

file

909 bytes

09fae12024ddcb70…

.github/scripts/lint-commit.py

file

10,973 bytes

4150d4e3e5d2125c…

.github/SUPPORT.md

file

788 bytes

a908051344fc7794…

.github/workflows/validate.yml

file

2,261 bytes

8803886bddf5eebf…

assets/adr-template.md

asset

2,622 bytes

c6b5ef3d6e203106…

assets/production-gate.md

asset

4,220 bytes

378a3b65180b89b6…

assets/system-design-rfc.md

asset

4,373 bytes

fe87f4b42903fc67…

LICENSE

file

1,432 bytes

27f5afbe1a47cb57…

README.md

file

15,249 bytes

58bf982b0ce1a08c…

README.md

file

15,249 bytes

58bf982b0ce1a08c…

references/ai-agent-engineering.md

file

5,844 bytes

fde37298af3b2d53…

references/apis-and-data.md

file

8,389 bytes

794b9bcba862fadd…

references/architecture-and-distributed-systems.md

file

8,365 bytes

c473a9a9a1931dec…

references/constitution.md

file

8,833 bytes

5eedcd6cca8116f4…

references/frontend-and-language-overlays.md

file

6,362 bytes

8497715c2035454b…

references/principles-and-patterns.md

file

6,969 bytes

3ca03ad629bc586a…

references/reliability-observability-performance.md

file

7,274 bytes

1530ff78a6db9085…

references/security-and-privacy.md

file

6,915 bytes

4a2e2ad2efc0eb6a…

references/testing-quality-and-delivery.md

file

7,675 bytes

16746fe0815a256a…

scripts/test_validate_skill.py

file

9,035 bytes

8460991f37d082e4…

scripts/validate-skill.py

file

13,225 bytes

fdda3bf302e53415…

scripts/validate-skill.sh

file

642 bytes

c4f8cf2f037555c5…

SECURITY.md

file

1,973 bytes

1faa861d2a85f9c3…

SKILL.md

skill

8,080 bytes

22a4957cdc3289f0…

workflows/code-review.md

file

4,072 bytes

02955105d9d6cf34…

workflows/feature-implementation.md

file

3,628 bytes

e4d34441d6a13a8e…

workflows/incident-response.md

file

3,477 bytes

541a9f3d91dcc40d…

workflows/production-readiness.md

file

3,611 bytes

530217cd939d033b…

workflows/refactor-debug.md

file

3,628 bytes

81897a381b336c7c…

workflows/repository-bootstrap.md

file

3,514 bytes

c50c63b99c4f4f57…

workflows/system-design.md

file

3,841 bytes

1081669fe37abf2f…

Related plugins

Ordered by Trust Score. Listings cannot pay for these positions. Check each one fits your task before switching from Principal Engineer OS.

Alternatives in Agent Skills

See all Agent Skills plugins

More from YourAKShaw