瑶姬是西天王母的小女儿，住在天上的瑶池宫里。她自幼跟三元仙君学道，有一身变化无穷的仙术。后来，她被封为云华夫人，专司教导仙童玉女之职。
瑶姬喜欢游玩。一日，她来到巫山上空，不禁为其秀美的景色吸引。不料，有十二条蛟龙正在此兴风作浪，使当地云雨茫茫。瑶姬决心为人间除去恶龙。于是她手指蛟龙，施展法术。但闻惊雷滚滚，地动山摇。风平浪静后，十二条蛟龙已然化作了十二座大山。
这十二座大山堵住了巫峡，壅塞了长江，四周汪洋一片。为了治理水患，人间司职治水的大禹赶到此地。然而，这里山势高，水势急，治水十分不容易。大禹日夜忧愁。
瑶姬为大禹治水的精神所感动，便派侍女传授给他一些法术，同时，还派六位侍臣，施展仙术，疏导了三峡水道，让洪水畅通东海。大禹十分感谢神女瑶姬的帮助，就登上巫山，当面致谢。
大禹上到巫山之顶，见到了在游龙、彩凤、白鹤等簇拥下的瑶姬。瑶姬说：“你治水有功，但还要懂得天地间事物变化的道理。”说完，又赠予大禹一部治水用的黄绫宝卷。大禹得了天书，拜谢而去。
水患治理后，瑶姬继续留在巫山过她的神仙日子。她喜欢变幻成一座秀丽挺拔的山峰，长久的伫立在巫山上观看日出日落，欣赏这美景。她的侍从也化作了一座座山峰，静静的守卫在神女的身旁。
至今，在今天四川巫山一带，还流传着由瑶姬幻化的神女峰的传说。当地百姓尊称瑶姬为“妙用真人”，还在飞凤峰山麓，为她修建了一座凝真观（即神女庙）。山腰上的一块平台，即神女向夏禹授书的授书台。